项目正在快速迭代中,API 与视觉细节可能随版本调整,请勿用于生产环境。
仅桌面端保证样式

Steps 步骤条 ​

引导用户按步骤完成任务的导航条,由 eb-step 声明各步骤(按挂载顺序编号)。容器通过 active 自动推算每步状态:索引小于 active 的为完成态、等于的为进行态、大于的为等待态;status 可对单个步骤显式覆盖,支持竖向、居中与简洁模式。

基础用法 ​

active 为当前步骤索引(从 0 开始),步骤状态随其联动变化。

1
提交申请
填写并提交工单
1
审核中
等待管理员审核
1
处理中
工程师跟进处理
1
已完成

动态推进 ​

active 响应式变化即可驱动步骤条,常与表单分步、向导流程配合;点击按钮观察三种状态(完成 / 进行 / 等待)的切换。

1
注册账号
填写基础信息
1
实名认证
上传证件照片
1
开通服务
选择服务套餐
1
完成

竖向与自定义状态 ​

direction="vertical" 竖向排列,space 控制步骤间距(数字按 px,也可传 CSS 宽度);status 显式指定某步状态(如 error),优先级高于自动推算。

1
注册账号
2026-08-01 完成
1
实名认证
审核未通过
1
开通服务
认证通过后可操作

状态语义变体 ​

process-status 定义当前步骤的样式语义,finish-status 定义已完成步骤的样式语义,均支持 wait / process / finish / error / success 五种状态。

1
身份校验
1
风控审核
触发风控规则
1
放款

简洁模式 ​

simple 使用轻量样式(无连接线、图标缩小、自动居中,效果等同同时开启 align-center),适合表单顶部或弹窗内的进度提示。

1
下单
1
支付
1
收货

图标与插槽 ​

icon 传入图标名后替代序号圆圈;#icon、#title、#description 插槽可分别完全接管图标区、标题与描述。

账号注册
已注册
OTP
安全验证
短信验证码校验
1
开通服务
等待开始

API ​

Steps Props

参数说明类型默认值
active当前步骤索引(从 0 开始)number0
direction排列方向horizontal | verticalhorizontal
space步骤宽度间距(数字按 px,字符串按 CSS 值),作用于 flex-basisnumber | string
processStatus当前步骤状态wait | process | finish | error | successprocess
finishStatus已完成步骤状态wait | process | finish | error | successfinish
alignCenter标题居中(simple 模式自动生效)booleanfalse
simple简洁模式(自动居中,隐藏连接线)booleanfalse

Steps Slots

参数说明类型默认值
defaulteb-step 列表——

Step Props

参数说明类型默认值
title步骤标题string
description步骤描述string
icon图标名(设置后替代序号圆圈;simple 模式图标为 16px,否则 22px)string
status手动指定状态,覆盖基于 active 的自动推算wait | process | finish | error | success

Step Slots

参数说明类型默认值
icon自定义图标区(完全接管 head 区域)——
title自定义标题——
description自定义描述——