Steps 步骤条

步骤条组件,引导用户按照流程完成任务的导航条,支持水平和垂直方向

步骤条组件,引导用户按照流程完成任务的导航条,支持水平和垂直方向

演示

9:41

代码示例

<!-- 默认水平步骤条 -->
  <re-steps class="demo-default" :current="0">
  <re-step-item title="步骤一" content="描述一" />
  <re-step-item title="步骤二" content="描述二" />
  <re-step-item title="步骤三" content="描述三" />

<!-- 当前步骤为第二步 -->
  <re-steps class="demo-current-1" :current="1">
  <re-step-item title="第一步" content="已完成" />
  <re-step-item title="第二步" content="进行中" />
  <re-step-item title="第三步" content="待处理" />

<!-- 垂直方向 -->
  <re-steps class="demo-vertical" direction="vertical" :current="1">
  <re-step-item title="提交申请" content="2024-01-01" />
  <re-step-item title="审核中" content="2024-01-02" />
  <re-step-item title="审核完成" content="" />

<!-- 只读模式 -->
  <re-steps class="demo-readonly" :current="1" :readonly="true">
  <re-step-item title="步骤一" content="" />
  <re-step-item title="步骤二" content="" />
  <re-step-item title="步骤三" content="" />

<!-- 自定义样式 -->
  <re-steps class="demo-custom-style" :current="0" customStyle="padding: 10px;">
  <re-step-item title="自定义" content="" />
  <re-step-item title="样式" content="" />

<!-- 错误状态 -->
  <re-steps class="demo-error" :current="1">
  <re-step-item title="步骤一" content="" />
  <re-step-item title="步骤二" content="出错" status="error" />
  <re-step-item title="步骤三" content="" />

<!-- 完成状态 -->
  <re-steps class="demo-finish" :current="2">
  <re-step-item title="步骤一" content="" />
  <re-step-item title="步骤二" content="" />
  <re-step-item title="步骤三" content="" />

<!-- 垂直方向多步骤 -->
  <re-steps class="demo-vertical-multi" direction="vertical" :current="2">
  <re-step-item title="注册账号" content="填写基本信息" />
  <re-step-item title="验证邮箱" content="点击邮件链接" />
  <re-step-item title="完善资料" content="上传头像" />
  <re-step-item title="开始使用" content="" />

引入

推荐使用 easycom 模式,配置后无需手动 import 即可直接使用 <re-steps />。

API

Steps Props

名称类型默认值描述必传
currentnumber0当前步骤的索引值,从 0 开始N
direction"horizontal" | "vertical""horizontal"步骤条方向,可选值:horizontal/verticalN
readonlybooleanfalse是否只读N
optionsArray<UTSJSONObject>步骤条数据,当不使用 re-step-item 子组件时可直接传入数据数组N
customStylestring""自定义样式N

Steps Events

名称参数描述
changecurrent: number当前步骤变化时触发,参数为新的步骤索引值

Steps Slots

名称描述
default默认插槽

StepItem Props

名称类型默认值描述必传
titlestring""步骤标题N
contentstring""步骤描述内容N
iconstring""步骤图标N
status"default" | "process" | "finish" | "error""default"当前步骤状态,可选值:default/process/finish/errorN
colorstring"#0052d9"主题色,用于进行中/已完成的状态与连接线N

StepItem Events

名称参数描述
clickindex: number点击步骤项时触发,参数为步骤索引