uni-app progress 组件使用详解

在 uni-app 开发中,progress 组件常用于展示任务加载进度,例如文件上传、页面初始化加载、下载进度等。该组件使用简单、样式灵活,并支持动态绑定进度值。

本文将详细介绍 progress 组件的常见用法及完整示例。

一、基础用法

最简单的使用方式如下:

html 复制代码
<progress :percent="myPercent" activeColor="#007AFF" stroke-width="12rpx" />

export default {
    data() {
        return {
            myPercent: 50
        }
    }
}

说明:

  • percent:进度值,范围 0 ~ 100

  • activeColor:已完成进度颜色

  • stroke-width:进度条高度


二、常用属性说明

属性 类型 说明
percent Number 进度百分比
activeColor String 已完成颜色
backgroundColor String 未完成颜色
stroke-width Number / String 进度条宽度
show-info Boolean 是否显示百分比文本
active Boolean 是否显示动画

示例:

html 复制代码
<progress
    :percent="myPercent"
    active
    show-info
    activeColor="#007AFF"
    backgroundColor="#eee"
    stroke-width="16rpx"
/>

三、实现动态加载进度(模拟加载)

实际项目中,进度通常是动态变化的,例如 3 秒加载完成:

html 复制代码
<template>
    <view>
        <progress :percent="myPercent" active stroke-width="12rpx" />
    </view>
</template>

<script>
export default {
    data() {
        return {
            myPercent: 0
        }
    },
    onLoad() {
        let timer = setInterval(() => {
            if (this.myPercent >= 100) {
                clearInterval(timer)
            } else {
                this.myPercent += 2   // 每次增加2%
            }
        }, 60) // 约3秒完成
    }
}
</script>

这样即可实现更真实的加载动画效果。


四、常见使用场景

progress 组件常用于:

  • 页面初始化加载

  • 文件上传进度

  • 下载进度显示

  • 视频缓存进度

  • 任务执行进度提示

例如:

html 复制代码
<progress :percent="uploadPercent" activeColor="#4CD964" />

五、开发建议

在真实业务中,推荐:

  1. 进度值绑定真实接口返回

  2. 在进度到 100% 时触发下一步操作

  3. 对加载时间较短的接口,可使用 假进度动画 + 完成校正

例如:

复制代码
if(realProgress > myPercent){
    myPercent = realProgress
}

可避免进度条卡顿。


六、总结

progress 是 uni-app 中非常常用的展示组件,具有:

  • 使用简单

  • 支持动态更新

  • 跨端兼容

  • 样式灵活

相关推荐
码间留白1 天前
AI 给的两个方案都被我否了:把 startIcon 与启动遮罩做成同一张图,鸿蒙 APP 冷启动零白屏
性能优化·uni-app·ai编程·harmonyos
anyup1 天前
自带 uni-app x 页面级能力,uView Pro X 8 个开箱即用的工具函数
前端·vue.js·uni-app
码间留白6 天前
六轮真机实验后,我把鸿蒙直播推流的 UI 全逼成了原生——uni-app 适配 HarmonyOS NEXT 完整复盘
uni-app·鸿蒙·harmonyos next·直播推流·arkts/arkui
wuxianda10308 天前
2026 苹果审核 4.3 (a) 被拒全解析|Guideline 4.3a spam 马甲包拒审原因 + 避坑方案
flutter·uni-app·苹果上架
头发还在的女程序员9 天前
基于 Spring Boot + Vue 3 + uni-app 的灵活用工系统:四端架构与业务流程设计
vue.js·spring boot·uni-app·灵活用工·灵工系统
Dumbness11 天前
订阅消息弹窗必须在用户点击里调:联调实验室里 timing 和 Mock 支付通知踩的坑
javascript·uni-app
码间留白12 天前
uni-app 鸿蒙离线打包:一个改动从源码到真机要穿过几条链
uni-app·鸿蒙·deveco·离线打包·uts插件
多客:duokelijie13 天前
代练订单系统选型思路:跨品类游戏接入、订单分层管理、自动结算逻辑拆解!
数据库·mysql·微信小程序·前端框架·uni-app·php·持续部署
码间留白13 天前
鸿蒙端对接 BLE 血压计:从一次握手到读数入库(二)设备篇
物联网·uni-app·鸿蒙·蓝牙ble·血压计
华玥作者14 天前
Vue 3 + TypeScript + uni-app 组件库推荐:hy-app(华玥组件库)
vue.js·typescript·uni-app