跳到主要内容

Steps 步骤条 ​

uni-appH5微信小程序App

跨端流程步骤条,支持横向、纵向和当前步骤状态。

何时使用 ​

多步流程引导:下单、注册、审批进度等。

何时不使用 ​

步骤需要点击跳转或自由回退编辑时,用 Tabs 或自定义导航。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Steps 步骤条 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
currentnumber0当前步骤索引(0 起);小于它的为完成,等于为进行中,大于为待办
itemsStepItem[]-步骤项:{ title, description? }
directionstring:'horizontal' | 'vertical'"horizontal"排列方向
sizestring:'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" />