::: sourceCode
## progress
> issues: https://issues.dcloud.net.cn/?mid=component.basic-content.progress
> 源码: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-progress/components/progress
:::
> 组件类型:UniProgressElement
进度条
### 兼容性
Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61
### 属性
| 名称 | 类型 | 默认值 | 兼容性 | 描述 |
| :- | :- | :- | :-: | :- |
| duration | number | 30 | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: x; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 进度增加1%所需毫秒数 |
| percent | number | 0 | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 进度百分比 |
| show-info | boolean | false | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 是否显示进度条值 |
| border-radius | number | 0 | Web: x; 微信小程序: 4.41; 支付宝小程序: x; Android: 3.9; iOS: 4.11; HarmonyOS(Vapor): 5.0 | 进度条圆角 |
| font-size | number | 12 | Web: x; 微信小程序: 4.41; 支付宝小程序: x; Android: 3.9; iOS: 4.11; HarmonyOS(Vapor): 5.0 | 进度条字体大小 |
| stroke-width | number | 3 | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 进度条宽度 |
| activeColor | string([string.ColorString](/uts/data-type.md#ide-string)) | "#007aff" | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 已选择的进度条的颜色 |
| background-color | string([string.ColorString](/uts/data-type.md#ide-string)) | "#ebebeb" | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 未选择的进度条的颜色 |
| active | boolean | false | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 是否启用动画 |
| active-mode | string | "backwards" | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: x; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 动画模式 |
| @activeend | (event: [UniProgressActiveendEvent](#uniprogressactiveendevent)) => void | | Web: x; 微信小程序: 4.41; 支付宝小程序: x; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 动画完成事件 |
| ~~color~~ | string | | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: x; Android: x; iOS: x; HarmonyOS: x | *(string)*
进度条颜色(请使用activeColor) |
#### active-mode 的属性描述
| 合法值 | 兼容性 | 描述 |
| :- | :-: | :- |
| backwards | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: x; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 动画从头播 |
| forwards | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: x; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 动画从上次结束点接着播 |
### 事件
#### UniProgressActiveendEvent
```mermaid
graph LR
UniProgressActiveendEvent -- Extends --> UniCustomEvent<UniProgressActiveendEventDetail>
style UniCustomEvent<UniProgressActiveendEventDetail> color:#42b983
click UniCustomEvent<UniProgressActiveendEventDetail> "https://doc.dcloud.net.cn/uni-app-x/component/common.html#unicustomevent"
```
##### UniProgressActiveendEventDetail
###### UniProgressActiveendEventDetail 的属性值
| 名称 | 类型 | 必填 |
| :- | :- | :- |
| curPercent | number | 是 |
### 示例
示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/component/progress/progress.uvue),与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/component/progress/progress.uvue)
::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/progress/progress
> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/component/progress/progress
>示例
```vue
```
:::
### 参见
- [参见uni-app相关文档](https://uniapp.dcloud.io/component/progress.html)