uni-app实现简单的进度条动画 uni-app progress组件用法

陌丽小哥_6198

陌丽小哥_6198

2026-05-22

181人浏览

原创

uni-app 的 progress 组件不支持 CSS 动画,因其为原生组件且 Web 端 标签样式受限;跨端一致方案是用 view 嵌套 + width 过渡动画实现。

uni-app实现简单的进度条动画 uni-app progress组件用法

uni-app 的 progress 组件本身不支持 CSS 动画驱动的“动态填充”效果,直接绑定 percent 值也不会自动产生过渡动画——这是最常见的误解起点。

为什么 progress 绑定 percent 后没有动画

uni-app 的 progress 是原生组件(iOS/Android 分别映射为 UIProgressView 和 ProgressBar),其 percent 属性变更时不会触发 CSS 过渡。Web 端虽渲染为 标签,但浏览器对它的样式控制极弱,transition 几乎无效。

  • 你改了 v-model:percent="current",数值变了,但视觉上是“跳变”,不是“滑动”
  • 试图给 progress 加 transition: width 0.3s 没用——它不是靠 width 实现进度,而是内部绘制
  • H5 端可 hack,但小程序端完全不可控,必须换思路

用 view + animation 手写一个可动画的进度条

真正可控、跨端一致的方案是:放弃 progress 组件,用两个 view 嵌套 + uni.createAnimation 或 CSS transform 驱动宽度变化。

  • 外层 view 设固定宽高和 overflow: hidden
  • 内层 view 设背景色、初始 width: 0%,通过 :style="{ width: current + '%' }" 控制长度
  • 关键:给内层加 transition: width 0.3s ease-in-out —— 这个在 H5 和小程序(基础库 2.7.1+)都生效
  • 示例代码片段:
<view class="progress-bar"><view class="progress-inner" :style="{ width: current + '%' }"></view></view><style>
.progress-bar {
  height: 6px;
  background-color: #e5e5e5;
  border-radius: 3px;
  overflow: hidden;
}
.progress-inner {
  height: 100%;
  background-color: #007AFF;
  width: 0%;
  transition: width 0.3s ease-in-out;
}
</style>

小程序平台下 progress 的实际可用配置项

如果你仍想用原生 progress(比如需要兼容低版本或依赖其无障碍特性),只能接受无动画,但要注意几个易错参数:

uni-app
uni-app

uni-app 是基于 Vue 的跨端开发框架,适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载
  • stroke-width 在微信小程序中单位是 rpx,但支付宝小程序必须带单位(如 "6rpx"),不写会失效
  • activeColor 和 backgroundColor 接受十六进制("#007AFF")或英文色名("blue"),但部分安卓低端机不识别 rgb() 写法
  • show-info 仅 H5 和微信小程序支持,字节系(TikTok/抖音小程序)不支持,设了也不显示
  • 真机调试时发现进度条“卡住”,大概率是 percent 被设为 NaN 或负数——务必加校验:Math.max(0, Math.min(100, Number(val)))

动画过程需要手动控制节奏?用 setTimeout 或 requestAnimationFrame 驱动

当你的进度来自异步任务(如文件上传、接口轮询),不要直接把最终值赋给 current,否则还是跳变。得自己做插值。

  • 简单场景用 setTimeout 分步更新(适合总耗时明确):
  • const step = 5; let val = 0; const timer = setInterval(() => { val += step; this.current = Math.min(100, val); if (val >= 100) clearInterval(timer); }, 100);
  • 更平滑可用 requestAnimationFrame,但 uni-app 中需注意:H5 可直接用,小程序需用 uni.$nextTick 替代部分时机
  • 复杂逻辑建议封装成 useProgress 组合式函数,返回 start(to: number, duration: number) 方法

真正麻烦的不是怎么画一条线,而是“动画是否在所有平台看起来一致”——小程序里 transition 的兼容性边界比想象中窄,某些安卓 WebView 对 % 宽度过渡仍有渲染延迟。动手前先在目标机型上跑一遍内层 view 的 width 动画,比什么都靠谱。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

uni-app

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2883

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6283

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7190

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

7018

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

1003

5

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

0

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

0

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

0

10

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

20

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习