鸿蒙5.0版开发：ArkTS基础组件（进展）

最新推荐文章于 2024-12-10 14:38:52 发布

星星不闪包退1

最新推荐文章于 2024-12-10 14:38:52 发布

阅读量1.1k

点赞数 24

分类专栏： ArkUI ArkTS 鸿蒙5.0 文章标签： harmonyos 华为 android 鸿蒙 ArkTS

本文链接：https://blog.csdn.net/m0_69424697/article/details/142339738

版权

往期鸿蒙全套实战文章必看：

进展

进度条组件，用于显示内容加载或操作处理等进度。

说明：

该组件从API version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

子组件

无

接口

进度（选项： ProgressOptions<Type>）

创建进度组件，用于显示内容加载或操作处理进度。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

参数：

参数名	参数类型	必填	参数描述
选项	ProgressOptions<Type>	是	进度条组件参数。

ProgressOptions<Type>对象说明

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

参数名	参数类型	必填	参数描述
价值	数	是	指定当前进度值。设置小于0的数值时置为0，设置大于total的数值时置为total。默认值：0 卡片能力：从API version 9开始，该接口支持在ArkTS卡片中使用。
总	数	否	指定进度总长。设置小于等于0的数值时置为100。默认值：100 卡片能力：从API version 9开始，该接口支持在ArkTS卡片中使用。
类型8+	ProgressType	否	指定进度条类型。默认值：ProgressType.Linear 卡片能力：从API version 9开始，该接口支持在ArkTS卡片中使用。
style（已弃用）	ProgressStyle	否	指定进度条样式。该参数从API version8开始废弃，建议使用type替代。默认值：ProgressStyle.Linear

ProgressType8+枚举说明

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

名称	描述
线性	线性样式。从API version9开始，高度大于宽度的时候自适应垂直显示。
戒指	环形无刻度样式，环形圆环逐渐显示至完全填充效果。
日蚀	圆形样式，显示类似月圆月缺的进度展示效果，从月牙逐渐变化至满月。
ScaleRing 系列	环形有刻度样式，显示类似时钟刻度形式的进度展示效果。从API version9开始，刻度外圈出现重叠的时候自动转换为环形无刻度进度条。
胶囊	胶囊样式，头尾两端圆弧处的进度展示效果与Eclipse相同;中段处的进度展示效果与Linear相同。高度大于宽度的时候自适应垂直显示。

ProgressStyle枚举说明

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

名称	描述
线性	线性样式。
戒指8+	环形无刻度样式，环形圆环逐渐显示至完全填充效果。
日蚀	圆形样式，显示类似月圆月缺的进度展示效果，从月牙逐渐变化至满月。
ScaleRing8+	环形有刻度样式，显示类似时钟刻度形式的进度展示效果。
胶囊8+	胶囊样式，头尾两端圆弧处的进度展示效果与Eclipse相同;中段处的进度展示效果与Linear相同。高度大于宽度的时候自适应垂直显示。

属性

除支持通用属性外，还支持以下属性：

价值

value（值：数字）

设置当前进度值。设置小于0的数值时置为0，设置大于total的数值时置为total。非法数值不生效。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力：SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
价值	数	是	当前进度值。默认值：0

颜色

color（值： ResourceColor |LinearGradient）

设置进度条前景色。

从API version 10开始支持利用LinearGradient设置Ring样式的渐变色。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用，暂不支持LinearGradient。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力：SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
价值	资源颜色 \|线性梯度10+	是	进度条前景色。默认值： - 胶囊： API 版本 9及以下：'#ff007dff' API版本 10：'#33006cde' API 版本 11及以上：'#33007dff' - 环： API 版本 9及以下：'#ff007dff' API 版本 10及以上：起始端：'#ff86c1ff'，结束端：'#ff254ff7' - 其他样式：'#ff007dff'