更新记录
1.0.0(2026-11-17) 下载此版本
新增
- 首次发布
- 步骤条组件,支持
horizontal横向 /vertical纵向两种布局 - 完成 / 进行中 / 未开始三态:主题色实底圆 + 白色 ✓、白底主题色边框圆 + 主题色数字、灰底灰数字
- 连接线完成段主题色、未完成段 #e5e5e5,两端透明占位保持步骤圆居中
options支持desc描述文案(存在才渲染)clickable开启后点击步骤触发click事件(参数 index),active由外部自行更新activeColor主题色可配,纯 CSS 实现,无图标 / 图片依赖
平台兼容性
uni-app(5.0)
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| - | √ | √ | √ | √ | - | √ | √ | √ |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | - | - | - | - | - | - | - | - | - |
ry-steps 步骤条
步骤条组件(uni-app / Vue3 版):horizontal 横向 / vertical 纵向两种布局,完成 / 进行中 / 未开始三态(主题色实底圆 + 白色 ✓、白底彩边圆 + 彩色数字、灰底灰数字),连接线完成段主题色。支持 desc 描述文案与 clickable 点击切换,一套 API 覆盖注册流程、物流跟踪、订单状态、任务进度等场景。
需要 uni-app x(uvue)版本请使用 ry-steps-x。
安装
三种方式任选其一。
方式一:uni_modules 导入(推荐)
通过 HBuilderX 从插件市场导入 uni_modules,组件位于 uni_modules/ry-steps/components/ry-steps/ 下,easycom 自动注册,无需 import。
方式二:源码放到 components 目录
下载源码后,把组件放到项目的 components/ry-steps/ry-steps.vue,保持该目录结构,即符合 easycom 默认规则,自动注册。
方式三:手动导入
组件放在其他任意位置时,显式导入注册即可,与 easycom 不冲突(显式导入优先生效):
import rySteps from '@/components/ry-steps/ry-steps.vue'
使用示例
<template>
<!-- 1. 最简用法:横向步骤条 -->
<ry-steps :options="simpleOptions" :active="1"></ry-steps>
<!-- 2. 带描述文案 -->
<ry-steps :options="options" :active="1"></ry-steps>
<!-- 3. 纵向步骤条 -->
<ry-steps :options="options" :active="2" direction="vertical"></ry-steps>
<!-- 4. 可点击切换 -->
<ry-steps :options="options" :active="active" :clickable="true" @click="onStepClick"></ry-steps>
<!-- 5. 自定义主题色 -->
<ry-steps :options="options" :active="1" active-color="#07c160"></ry-steps>
</template>
<script setup>
import { ref } from 'vue'
const simpleOptions = [{ title: '下单' }, { title: '付款' }, { title: '发货' }, { title: '收货' }]
const options = [
{ title: '步骤一', desc: '填写基本信息' },
{ title: '步骤二', desc: '确认订单信息' },
{ title: '步骤三', desc: '完成提交' }
]
const active = ref(1)
// clickable 时点击步骤,active 由外部自行更新
const onStepClick = (index) => {
active.value = index
}
</script>
API
Props
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| options | Array | [] | 步骤数据 [{ title, desc? }],title 必填、desc 可选 |
| active | Number | 0 | 当前进行到的索引:index < active 已完成、== active 进行中、> active 未开始 |
| direction | String | 'horizontal' | 布局方向:horizontal 横向 / vertical 纵向 |
| activeColor | String | '#2f6bff' | 主题色(完成态圆底、进行中边框与数字、完成段连接线) |
| clickable | Boolean | false | 是否可点击切换(触发 click 事件,active 由外部自行更新) |
Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| click | 点击步骤时触发(仅 clickable 时触发) | index:被点击步骤的索引 |
Slots
本组件无插槽,内容由 options 驱动。
三态说明
- 已完成(index < active):主题色实底圆 + 白色 ✓ 文字,标题 #666666
- 进行中(index == active):白底 + 主题色边框圆 + 主题色数字,标题主题色加粗
- 未开始(index > active):#f5f5f6 底 + #999999 数字,标题 #666666
- 连接线:完成段主题色、未完成段 #e5e5e5(进行中步骤的入口线视为完成段)
实现说明
横向每步 flex: 1 等宽纵向排列,头部为「左线 + 圆 + 右线」横向结构(首尾端透明占位线保持圆居中);纵向每步为「左列(圆 + 竖线)+ 右侧内容」横向结构。全部基于 flex + 纯 CSS 实现,无图标字体、图片依赖,全端(H5 / 小程序 / App)表现一致。
技术支持
- 微信:howe1144(一定在线,紧急问题首选)
- QQ 群:415367029(常规问题,群友互助,作者可能在线)
- ***(很少在线)
- 插件市场评论区:回复不及时,仅适合不着急的留言反馈
支持与赞赏
如果你觉得本插件解决了你的问题,可以考虑支持作者:
| 支付宝赞助 | 微信赞助 |
|---|---|
![]() |
![]() |

收藏人数:
下载插件并导入HBuilderX
赞赏(0)


下载 3
赞赏 0
下载 12771027
赞赏 1959
赞赏
京公网安备:11010802035340号