Vue 3步骤条通过v-for遍历steps数组,用:class动态绑定is-active/is-completed状态类;连线样式由相邻步骤状态决定;currentStepName prop驱动computed计算各步status,实现响应式切换。

在 Vue 3 模板中实现步骤条的状态样式切换,核心是根据每个步骤的当前状态(pending、completed、active)动态绑定对应的 class,并配合结构循环与条件渲染完成视觉区分。
用 v-for 渲染步骤项并按状态绑定 class
每个步骤应是一个对象,含 name 和 status 字段。模板中通过 v-for 遍历 steps 数组,再用对象语法为 :class 动态添加状态类:
-
:class="{ 'is-active': step.status === 'active', 'is-completed': step.status === 'completed' }"—— 仅当匹配时才启用对应样式 - 未匹配状态(即
pending)默认不加特殊 class,可统一设基础样式(如灰色文字、空心圆点) - 注意避免使用全局布尔变量控制所有步骤,否则会全部同步切换
步骤连线的样式逻辑要关联相邻状态
连接线本身没有独立状态,它的样式取决于前一步是否已完成、或后一步是否激活:
- 用
v-if="index 控制只渲染到倒数第二个步骤后 - 连线 class 可写为:
:class="{ 'is-completed': steps[index].status === 'completed', 'is-active': steps[index + 1].status === 'active' }" - 这样当第 2 步是
active时,第 1 步后的连线显示为激活态;当第 1 步变为completed,该连线也自动转为完成态
状态更新靠父组件传入当前步骤名称驱动
组件内部不维护“当前步”逻辑,而是接收一个 currentStepName prop,再在 setup 中计算每个步骤的 status:
- 遍历
steps,比对step.name === currentStepName→ 设为active - 若该步骤在
currentStepName之前 → 设为completed - 若在之后 → 保持
pending - 这个计算过程建议用
computed封装,确保响应式更新
箭头与图标可通过伪元素或内联 SVG 实现
连线右侧的箭头不推荐用图片,更灵活的方式是:
- 在
.step-line::after中用 CSS 绘制三角形箭头,并随is-active类改变颜色 - 或直接在模板中插入简短 SVG,用
v-show控制不同状态下显示不同图标(如 ✔️、▶️、○) - 确保箭头方向与流程走向一致,且在
is-completed状态下与步骤圆点颜色统一
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










