更新记录
1.0.0(2026-11-17) 下载此版本
新增
- 首次发布
- 步骤条组件(uni-app x / uvue 版),支持
direction="horizontal"横向与direction="vertical"纵向双布局 - 三态:已完成(实底圆 + 白色 ✓)/ 进行中(白底彩边圆 + 彩色数字)/ 未开始(灰底灰数字)
- 连接线完成段主题色、未完成段灰色,首尾透明占位保证步骤圆居中
options每项支持desc描述文案(存在才渲染),activeColor主题色可配clickable开启后点击步骤触发click事件(参数 index),active由外部自行更新- 纯 CSS 实现无渐变 / 无动画,App-Android / iOS / 鸿蒙 / Web / 小程序表现一致
平台兼容性
uni-app x(5.0)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ |
ry-steps-x 步骤条(uni-app x)
步骤条组件(uni-app x / uvue 版):横向 / 纵向双布局,已完成 / 进行中 / 未开始三态清晰,连接线随进度自动变色。支持为每一步补充描述文案(desc)、自定义主题色,以及开启后点击步骤切换当前步(clickable)。适用于下单流程、审批进度、物流跟踪、资料完善等场景。
需要 uni-app(Vue3)版本请使用 ry-steps。
安装
三种方式任选其一。
方式一:uni_modules 导入(推荐)
通过 HBuilderX 从插件市场导入 uni_modules,组件位于 uni_modules/ry-steps-x/components/ry-steps/ 下,easycom 自动注册,无需 import。
方式二:源码放到 components 目录
下载源码后,把组件放到项目的 components/ry-steps/ry-steps.uvue,保持该目录结构,即符合 easycom 默认规则,uni-app x 自动注册。
方式三:手动导入
组件放在其他任意位置时,显式导入注册即可,与 easycom 不冲突(显式导入优先生效):
import rySteps from '@/components/ry-steps/ry-steps.uvue'
使用示例
<template>
<!-- 1. 横向基础用法 -->
<ry-steps :options="options" :active="1"></ry-steps>
<!-- 2. 纵向布局 -->
<ry-steps :options="options" :active="1" direction="vertical"></ry-steps>
<!-- 3. 自定义主题色 -->
<ry-steps :options="options" :active="2" active-color="#07c160"></ry-steps>
<!-- 4. 可点击切换 -->
<ry-steps :options="options" :active="active" :clickable="true" @click="onStepClick"></ry-steps>
</template>
<script setup lang="uts">
import { ref } from 'vue'
// 步骤数据:title 必填,desc 可选
const options : any[] = [
{ title : '下单' },
{ title : '付款', desc : '支持多种支付方式' },
{ title : '发货' },
{ title : '收货' }
]
const active = ref<number>(0)
const onStepClick = (index : number) => {
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:步骤索引 |
状态说明
| 状态 | 判定 | 表现 |
|---|---|---|
| 已完成 finish | index < active | 实底主题色圆 + 白色 ✓ |
| 进行中 process | index == active | 白底彩边圆 + 主题色数字,标题主题色加粗 |
| 未开始 wait | index > active | 灰底圆 + 灰色数字 |
实现说明
横向每步 flex: 1 等宽,纵向每步左侧「圆 + 上下竖线」、右侧标题与描述左对齐;首尾连接线用透明占位,保证步骤圆始终居中。全部基于纯 CSS 实现,无渐变、无动画,App-Android / iOS / 鸿蒙 / Web / 小程序表现一致。
技术支持
- 微信:howe1144(一定在线,紧急问题首选)
- QQ 群:415367029(常规问题,群友互助,作者可能在线)
- ***(很少在线)
- 插件市场评论区:回复不及时,仅适合不着急的留言反馈
支持与赞赏
如果你觉得本插件解决了你的问题,可以考虑支持作者:
| 支付宝赞助 | 微信赞助 |
|---|---|
![]() |
![]() |

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


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