更新记录
1.0.0(2026-11-17) 下载此版本
新增
- 首次发布
- 进度条组件,支持
line线形 /circle环形两种形态 percent驱动进度,duration控制过渡动画时长color/trackColor自由配色,strokeWidth控制线形高度与环形描边粗细- 环形支持
size自定义直径,中心百分比文字显隐可配 - 环形基于「双半圆窗口 + 圆盘旋转」纯 CSS 实现,无 canvas / SVG / conic-gradient 依赖,全端通用
平台兼容性
uni-app(5.0)
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| - | √ | √ | √ | √ | - | √ | √ | √ |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | - | - | - | - | - | - | - | - | - |
ry-progress 进度条
进度条组件(uni-app / Vue3 版):line 线形 / circle 环形两种形态,percent 驱动并带过渡动画。通过 color / trackColor 自由配色,粗细、直径、百分比文字全部可配,一套 API 覆盖下载进度、上传进度、任务完成率、数据指标等场景。
需要 uni-app x(uvue)版本请使用 ry-progress-x。
安装
三种方式任选其一。
方式一:uni_modules 导入(推荐)
通过 HBuilderX 从插件市场导入 uni_modules,组件位于 uni_modules/ry-progress/components/ry-progress/ 下,easycom 自动注册,无需 import。
方式二:源码放到 components 目录
下载源码后,把组件放到项目的 components/ry-progress/ry-progress.vue,保持该目录结构,即符合 easycom 默认规则,uni-app 自动注册。
方式三:手动导入
组件放在其他任意位置时,显式导入注册即可,与 easycom 不冲突(显式导入优先生效):
import ryProgress from '@/components/ry-progress/ry-progress.vue'
使用示例
<template>
<!-- 1. 最简用法:线形进度条 -->
<ry-progress :percent="60"></ry-progress>
<!-- 2. 环形进度条 -->
<ry-progress type="circle" :percent="70"></ry-progress>
<!-- 3. 自定义颜色与粗细 -->
<ry-progress :percent="80" color="#ff4757" track-color="#ffeaea" :stroke-width="20"></ry-progress>
<ry-progress type="circle" :percent="80" color="#07c160" track-color="#e8f5e9" :stroke-width="16"></ry-progress>
<!-- 4. 环形尺寸与文字可配 -->
<ry-progress type="circle" :percent="50" :size="200" :text-size="32"></ry-progress>
<ry-progress type="circle" :percent="50" :show-text="false"></ry-progress>
<!-- 5. 动态进度 -->
<ry-progress :percent="percent" type="circle"></ry-progress>
<view @click="percent = Math.min(percent + 10, 100)">增加</view>
</template>
<script setup>
import { ref } from 'vue'
const percent = ref(30)
</script>
API
Props
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| percent | Number | 0 | 进度百分比(0 - 100,越界自动截断) |
| type | String | 'line' | 形态:line 线形 / circle 环形 |
| color | String | '#2f6bff' | 进度条颜色 |
| trackColor | String | '#e5e5e5' | 轨道(底环)颜色 |
| strokeWidth | Number | 12 | 线形高度 / 环形描边粗细(rpx) |
| size | Number | 160 | 环形直径(rpx,仅 circle 生效) |
| showText | Boolean | true | 是否显示百分比文字 |
| textColor | String | '#666666' | 文字颜色 |
| textSize | Number | 24 | 文字字号(rpx) |
| duration | Number | 600 | 进度过渡动画时长(ms) |
形态说明
- line(默认):横向进度条,右侧跟随百分比文字,
strokeWidth控制轨道高度 - circle:环形进度条,中心显示百分比文字,
size控制直径、strokeWidth控制描边粗细
实现说明
环形进度基于「双半圆窗口 + 全色圆盘旋转」纯 CSS 实现:两个 overflow: hidden 的半圆窗口各放一个与环等大的全色圆盘,通过 transform: rotate 旋转圆盘、由窗口裁剪出扇形进度,进度 ≤ 50% 时仅右半窗展开、> 50% 后左半窗接力补足。不依赖 canvas、SVG、conic-gradient 与 CSS Animation,全端(H5 / 小程序 / App)表现一致。
技术支持
- 微信:howe1144(一定在线,紧急问题首选)
- QQ 群:415367029(常规问题,群友互助,作者可能在线)
- ***(很少在线)
- 插件市场评论区:回复不及时,仅适合不着急的留言反馈
支持与赞赏
如果你觉得本插件解决了你的问题,可以考虑支持作者:
| 支付宝赞助 | 微信赞助 |
|---|---|
![]() |
![]() |

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


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