更新记录

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(常规问题,群友互助,作者可能在线)
  • ***(很少在线)
  • 插件市场评论区:回复不及时,仅适合不着急的留言反馈

支持与赞赏

如果你觉得本插件解决了你的问题,可以考虑支持作者:

支付宝赞助 微信赞助

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

无

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

许可协议

MIT协议

暂无用户评论。