OpenHarmony进度条的API接口有哪些

OpenHarmony 进度条相关 API 接口

ArkTS 声明式 UI（Progress）

• 组件构造
  • 接口：Progress(options: { value: number, total?: number, type?: ProgressType })
  • 说明：创建进度条；value 为当前进度，total 为进度总长（默认 100），type 指定样式（默认 ProgressType.Linear）。当 value < 0 时置为 0，当 value > total 时置为 total。从 API 9 起支持在 ArkTS 卡片 中使用。
• 枚举与样式类型
  • 枚举 ProgressType：Linear（线性）、Ring（环形无刻度）、ScaleRing（环形有刻度）、Eclipse（圆形）、Capsule（胶囊）。从 API 9 起，Linear/Capsule 在高度大于宽度时自适应为垂直显示；ScaleRing 在刻度外圈重叠时会自动转换为环形无刻度样式。
  • 样式对象（通过 .style() 设置）：ProgressStyleOptions，以及版本化样式映射 ProgressStyleMap（如 LinearStyleOptions10+、RingStyleOptions10+、EclipseStyleOptions10+、ScaleRingStyleOptions10+、CapsuleStyleOptions10+）。
• 主要属性
  • value(number)：动态设置当前进度（越界会被截断到 [0, total]）。
  • color(ResourceColor) / backgroundColor(ResourceColor)：设置进度条前景色与底色；注意组件的 backgroundColor 仅作用于进度条底色而非整个组件背景。
  • style(ProgressStyleOptions | CapsuleStyleOptions10+)：设置线条宽度、刻度数量/宽度等类型专属样式（不同 type 支持的键不同）。

JS 服务卡片（progress）

• 组件构造
  • 标签：<progress type="horizontal | circular | ring | scale-ring | arc | eclipse" percent="0..100" secondarypercent="0..100" ... />
  • 说明：用于卡片 UI，支持确定进度与次级进度（secondarypercent）。
• 关键属性
  • 通用：percent（当前进度，取值 0–100）、secondarypercent（次级进度，取值 0–100）。
  • 环形与刻度环：clockwise（是否顺时针，默认 true）、stroke-width（环宽，默认 10px）、scale-width（刻度粗细，仅 scale-ring）、scale-number（刻度数量，仅 scale-ring，默认 120）。
  • 弧形与圆形：start-angle（起始角度，默认 240°）、total-angle（总角度，默认 240°，负值表示逆时针）、center-x / center-y / radius（自定义弧线几何，需三者同时设置）。
  • 线性：color、stroke-width、background-color、secondary-color 等。

加载动画组件（LoadingProgress）

• 组件构造
  • 接口：LoadingProgress()
  • 说明：显示不确定进度的旋转圆形指示器，常用于网络请求、数据加载等场景；从 API 8 开始支持。
• 主要属性
  • color(ResourceColor)：设置指示器颜色（旋转圆点/轨迹颜色）。

版本与能力说明

• Progress 组件从 API 7 开始支持；ArkTS 卡片 支持自 API 9；元服务 支持自 API 11；对应系统能力为 SystemCapability.ArkUI.ArkUI.Full。
• Progress 的 style 参数已在 API 8 起废弃，建议使用 type 指定样式；ProgressType 与样式映射在 API 8+ / 10+ 逐步增强。