Steps 步骤条
uni-appH5微信小程序App
跨端流程步骤条,支持横向、纵向和当前步骤状态。
何时使用
多步流程引导:下单、注册、审批进度等。
何时不使用
步骤需要点击跳转或自由回退编辑时,用 Tabs 或自定义导航。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
current | number | 0 | 当前步骤索引(0 起);小于它的为完成,等于为进行中,大于为待办 |
items | StepItem[] | - | 步骤项:{ title, description? } |
direction | string:'horizontal' | 'vertical' | "horizontal" | 排列方向 |
size | string:'sm' | 'md' | 'lg' | "md" | 尺寸 |
示例
横向步骤
vue
<Steps :current="1" :items="steps" />纵向步骤
vue
<Steps :current="1" direction="vertical" :items="[{ title: '提交订单', description: '2026-06-18 09:30' }, { title: '仓库拣货', description: '预计 2 小时内完成' }, { title: '配送完成', description: '待更新' }]" />已完成
vue
<Steps :current="3" :items="steps" />