【HarmonyOS 5】鸿蒙中进度条的使用详解

【HarmonyOS 5】鸿蒙中进度条的使用详解

一、HarmonyOS中Progress进度条的类型

HarmonyOS的ArkUI框架为开发者提供了多种类型的进度条，每种类型都有其独特的样式，以满足不同的设计需求。以下是几种常见的进度条类型：

1. 线性进度条（Linear）：这是最常见的进度条样式，以直线的形式展示进度。从API version 9开始，当组件高度大于宽度时，它会自适应垂直显示；当高度和宽度相等时，保持水平显示。

2. 环形无刻度进度条（Ring）：这种进度条呈环形，通过环形圆环的逐渐填充来显示进度，默认前景色为蓝色，默认strokeWidth进度条宽度为2.0vp。

3. 环形有刻度进度条（ScaleRing）：它显示类似时钟刻度形式的进度展示效果。在头尾两端圆弧处的进度展示效果与圆形样式（Eclipse）相同，中段处的进度展示效果为矩形状长条，与线性样式相似。从API version 9开始，当刻度外圈出现重叠时，它会自动转换为环形无刻度进度条。

4. 椭圆形进度条（Eclipse）：显示类似月圆月缺的进度展示效果，从月牙逐渐变化至满月。

5. 胶囊进度条（Capsule）：头尾两端圆弧处的进度展示效果与椭圆形样式（Eclipse）相同，中段处的进度展示效果与线性样式（Linear）相同。当高度大于宽度时，它会自适应垂直显示。

三、使用ArkTS创建和设置进度条

（一）创建进度条

在ArkTS中，我们通过调用Progress接口来创建进度条。以下是创建进度条的基本语法：

Progress({ value: number, total?: number, type?: ProgressType })

（二）设置进度条样式

我们可以在创建进度条时，通过设置ProgressType枚举类型给type可选项指定不同的进度条类型，从而实现多样化的样式。以下是不同类型进度条的设置示例：

1. 线性进度条：

Progress({ value: 50, total: 100, type: ProgressType.Linear })

2. 环形无刻度进度条：

Progress({ value: 30, total: 100, type: ProgressType.Ring })

3. 环形有刻度进度条：

Progress({ value: 70, total: 100, type: ProgressType.ScaleRing })

4. 椭圆形进度条：

Progress({ value: 10, total: 100, type: ProgressType.Eclipse })

5. 胶囊进度条：

Progress({ value: 45, total: 100, type: ProgressType.Capsule })

（三）动态更新进度

进度条的关键功能之一是能够在任务执行过程中动态更新进度，以反映任务的实时进展。

在鸿蒙Progress组件中通过value和total两个属性来实现进度条得更新效果，源码如下：

其中，value用于设置初始进度值，total用于设置进度总长度，type决定Progress的样式。如果不设置type，默认使用线性进度条样式。

Progress({ value: 24, total: 100, type: ProgressType.Linear })

import prompt from '@ohos.prompt';@Entry
@Component
struct DownloadProgressBar {// 下载进度，初始值为 0@State progress: number = 0;// 下载状态提示信息@State status: string = '等待下载';// 模拟下载的函数startDownload() {// 模拟下载过程，使用 setInterval 定时更新进度let intervalId = setInterval(() => {this.progress += 10;if (this.progress >= 100) {this.status = '下载完成';clearInterval(intervalId);prompt.showToast({ message: '下载已完成' });} else {this.status = `下载中，进度: ${this.progress}%`;}}, 1000);}build() {Column({ space: 20 }) {Text('下载进度条示例').fontSize(20).fontWeight(FontWeight.Bold);Progress({ value: this.progress, total: 100 }).width('90%').height(20);Text(this.status).fontSize(16);Button('开始下载').width('60%').height(40).backgroundColor(Color.Blue).fontColor(Color.White).onClick(() => {this.startDownload();});}.width('100%').height('100%').alignItems(HorizontalAlign.Center).justifyContent(FlexAlign.Center);}
}