更新记录

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

支持与赞赏

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

支付宝赞助 微信赞助

隐私、权限声明

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

无

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

无

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

无

许可协议

MIT协议

暂无用户评论。