更新记录

1.0.0(2026-11-17) 下载此版本

新增

  • 首次发布
  • 进度条组件(uni-app x / uvue 版),支持 line 线形 / circle 环形两种形态
  • percent 驱动进度,duration 控制过渡动画时长
  • color / trackColor 自由配色,strokeWidth 控制线形高度与环形描边粗细
  • 环形支持 size 自定义直径,中心百分比文字显隐可配
  • 环形基于「双半圆窗口 + 圆盘旋转」纯 CSS 实现,无 canvas / SVG / conic-gradient 依赖,兼容 App-Android / iOS / 鸿蒙

平台兼容性

uni-app x(5.0)

Chrome Safari Android iOS 鸿蒙 微信小程序
√ √ √ √ √ √

ry-progress-x 进度条(uni-app x)

进度条组件(uni-app x / uvue 版):line 线形 / circle 环形两种形态,percent 驱动并带过渡动画。通过 color / trackColor 自由配色,粗细、直径、百分比文字全部可配,一套 API 覆盖下载进度、上传进度、任务完成率、数据指标等场景。

需要 uni-app(Vue3)版本请使用 ry-progress。

安装

三种方式任选其一。

方式一:uni_modules 导入(推荐)

通过 HBuilderX 从插件市场导入 uni_modules,组件位于 uni_modules/ry-progress-x/components/ry-progress/ 下,easycom 自动注册,无需 import。

方式二:源码放到 components 目录

下载源码后,把组件放到项目的 components/ry-progress/ry-progress.uvue,保持该目录结构,即符合 easycom 默认规则,uni-app x 自动注册。

方式三:手动导入

组件放在其他任意位置时,显式导入注册即可,与 easycom 不冲突(显式导入优先生效):

import ryProgress from '@/components/ry-progress/ry-progress.uvue'

使用示例

<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)"><text>增加</text></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(uvue App 端不支持),全端(App-Android / iOS / 鸿蒙 / Web / 小程序)表现一致。

技术支持

  • 微信:howe1144(一定在线,紧急问题首选)
  • QQ 群:415367029(常规问题,群友互助,作者可能在线)
  • ***(很少在线)
  • 插件市场评论区:回复不及时,仅适合不着急的留言反馈

支持与赞赏

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

支付宝赞助 微信赞助

隐私、权限声明

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

无

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

无

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

无

许可协议

MIT协议

暂无用户评论。