OpenHarmony进度条有哪些扩展功能

OpenHarmony 进度条扩展功能概览

一 多形态与自适应布局

• 支持多种进度条类型：Linear（线性）、Ring（环形）、ScaleRing（刻度环）、Eclipse（圆形月缺）、Arc（弧形）、Capsule（胶囊），覆盖从条形到圆形、从连续到刻度、从直线到弧线的多样展示需求。
• 自适应显示：从 API 9 起，Linear/Capsule 在高度大于宽度时会自动切换为垂直方向显示，提升不同尺寸容器中的可用性。
• 环形进度条行为增强：ScaleRing 在刻度外圈出现重叠时，会自动转换为环形无刻度样式，避免视觉混乱。
• 环形方向可控：支持设置**clockwise（顺时针/逆时针）**方向，满足不同 UI 规范与动效需求。

二 进度表达与控制能力

• 双进度支持：除主进度外，还支持secondarypercent（次级进度），常用于展示缓冲进度、多阶段任务进度等复合场景。
• 可配置总量：通过 total 自定义进度总量（默认 100），进度计算按 value/total 折算，适配非百分制场景。
• 数值边界处理：当 value < 0 时置为 0；当 value > total 时置为 total，保证显示与逻辑一致性。
• 多端可用：在 ArkTS 卡片中自 API 9 起可用，在元服务中自 API 11 起可用，便于在轻量卡片与元服务界面中复用。

三 样式与动效细粒度定制

• 线性进度条：可设置color（进度色）、stroke-width（进度条宽度）、background-color（背景色）、secondary-color（次级进度色），满足品牌色与对比度规范。
• 环形/刻度环：支持color、background-color、secondary-color、stroke-width，其中 ScaleRing 还可独立配置scale-width（刻度粗细）与scale-number（刻度数量），实现精细化刻度外观。
• 弧形/圆形：支持color、background-color、stroke-width，并可定制start-angle（起始角度）、total-angle（扫过角度）、center-x/center-y（中心位置）、radius（半径），实现从圆弧到完整圆环的多样弧形展示。
• 加载样式：提供 circular（loading 点状） 样式，可设置color（圆点颜色），用于不确定时长的加载状态。

四 交互与系统集成场景

• 事件机制：支持通用交互事件，可结合触摸/手势实现拖动式进度调节（如亮度、音量、播放进度等）。

• 典型系统集成示例：结合系统能力实现屏幕亮度调节，用进度条映射亮度值（范围 1–255），并可通过 setKeepScreenOn 保持常亮以便连续调节；进度条负责可视化与交互，系统接口负责实际设置与回调处理。