Skip to content

Steps 步骤条

引导用户按流程完成任务的步骤指示器,支持等待 / 进行中 / 完成 / 错误四种状态、纵向排布与可点击跳转。

基础用法

进行中

完成态

全部完成

初始步骤

初始等待

四种状态

通过每步的 status 字段显式指定状态:wait 等待(次要色 + 序号)、process 进行中(主色 + 序号)、finish 完成(成功色 + ✓)、error 错误(危险色 + ✕)。

wait / process / finish / error

可点击切换

clickable 开启后步骤项可点击跳转(整项可点,Enter/Space 键盘可达),点击派发 oas-change(detail 为 { index })并切换当前步。

点击步骤切换当前步

点状步骤

progress-dot 将步骤指示器切换为圆点(当前步圆点放大并带柔光晕),连线为细线;配合 clickable 圆点可点击跳转(含键盘)。

点状步骤

导航模式

navigation 将步骤切换为箭头导航条:当前步骤主色高亮、前序步骤浅主色、等待步骤灰色,描述隐藏;步骤项隐式可点(无需 clickable)。底部提供「上一步 / 下一步」按钮(首步/末步对应禁用),点击步骤或按钮都会派发 oas-change(detail 为 { index })并切换当前步。

导航模式(上一步 / 下一步)

无描述

仅标题

纵向

纵向方向

API

属性

属性说明类型默认值
clickable步骤可点击跳转(布尔,存在即开启)boolean
current当前步骤索引(0 起)string0
direction方向(导航模式下强制横向)stringhorizontal
navigation导航模式:箭头导航条 + 底部上一步/下一步按钮(布尔,存在即开启)boolean
progress-dot点状步骤:指示器为圆点、连线为细线(布尔,存在即开启)boolean
steps[{ title, description?, status? }] JSON 字符串StepItem[] | string[]

事件

事件说明
oas-change点击可点击步骤或导航按钮时触发(含键盘触发);detail: { index }(0 起)

状态规则:显式 statuswait / process / finish / error)优先;未指定时按 current 推导——索引 < currentfinish(✓),=== currentprocess,其余为 wait

基于 MIT OR Apache-2.0 双许可发布