OpenHarmony进度条支持哪些主题颜色

OpenHarmony 进度条颜色支持说明

颜色类型与取值

• 进度条（Progress）的颜色通过属性进行设置，核心包括：
  • 前景色：使用 color，类型为 ResourceColor，可直接使用主题色（如 Color.Blue）、十六进制色值（如 “#FF4500”）、资源引用或 LinearGradient 渐变色。若未显式设置，默认使用系统主题色。
  • 背景色：使用 backgroundColor，类型为 ResourceColor，常见默认值为 “#19000000”（透明黑）。
  • 环形样式专属：可使用 style({ strokeWidth: number }） 调整环宽，以控制进度条“轨道”的视觉厚度。
    以上属性在 ArkTS 的 Progress 组件中可用，适配常见版本（如 API 9+）。

内置与扩展的颜色能力

• 内置颜色能力：
  • 单色：如 Color.Red / Color.Blue / “#FF4500” 等任意颜色值。
  • 渐变色：通过 LinearGradient 设置多色过渡，用于强调型进度展示。
• 扩展与版本要点：
  • 部分版本/能力可能需要显式能力检测（如 SystemCapability.ArkUI.AdvancedProgress），以启用渐变等高级特性。
  • 若需超出内置能力的深度定制（特殊形状、复杂动画），可通过继承 Progress 或自定义组件实现。
    上述能力在官方示例与技术文章中均有体现。

不同进度条样式的颜色支持差异

• 线性（Linear）：支持设置 color（进度色）与 backgroundColor（轨道色），可用 strokeWidth / strokeRadius 调整线条与圆角。
• 环形（Ring / ScaleRing）：支持 color 与 backgroundColor，通过 strokeWidth 控制环宽；ScaleRing 还可用 scaleCount / scaleWidth 控制刻度效果。
• 胶囊（Capsule）：支持 color，并可通过 borderColor / borderWidth 设置边框，以及 content / font 展示文本（文本颜色通常通过 font 设置）。
  不同样式对背景色等属性的支持存在差异，实际以所用版本的 API 为准。

与 LoadingProgress 的颜色区别

• LoadingProgress 为加载状态指示器（无限动画），仅通过 color 设置前景色，常见默认值为 “#99666666”（API 10 及以下）、“#ff666666”（API 11 及以上）。它不表示确定性进度，与 Progress 的“主题色/自定义色”使用场景不同。