OpenHarmony进度条支持哪些格式

OpenHarmony进度条支持的格式（类型）及说明

OpenHarmony的进度条（Progress）组件通过type属性（或ProgressType枚举）支持多种显示格式，每种格式适用于不同的场景，以下是具体分类及特性：

1. 线性样式（Linear）

默认类型，用于水平或垂直方向的线性进度显示。

• 特性：当组件高度大于宽度时，自适应垂直显示；高度等于宽度时，保持水平显示。
• 适用场景：任务进度条、文件下载进度、安装进度等需要线性展示的场景。
• 示例代码：Progress({ value: 24, total: 100, type: ProgressType.Linear })。

2. 环形无刻度样式（Ring）

用于环形进度显示，无刻度标记。

• 特性：环形圆环逐渐填充，从左侧开始顺时针增长（默认顺时针）。
• 适用场景：加载动画、等待提示、循环任务进度等需要简洁环形展示的场景。
• 示例代码：Progress({ value: 40, total: 150, type: ProgressType.Ring }).width(100).height(100)。

3. 环形有刻度样式（ScaleRing）

带刻度的环形进度显示，类似时钟刻度。

• 特性：包含总刻度和刻度宽度（通过scaleCount和scaleWidth属性调整）；当刻度外圈重叠时，自动转换为环形无刻度样式。
• 适用场景：需要精确展示进度的场景（如倒计时、分阶段任务进度）。
• 示例代码：Progress({ value: 60, total: 100, type: ProgressType.ScaleRing }).width(120).height(120).scaleCount(12)。

4. 圆形样式（Eclipse）

显示类似“月圆月缺”的圆形进度效果。

• 特性：从月牙形状逐渐变化至满月，适合直观展示周期性或循环进度。
• 适用场景：天气应用（月相展示）、音乐播放器（循环进度）、健康数据（如睡眠周期）等。
• 示例代码：Progress({ value: 50, total: 100, type: ProgressType.Eclipse })。

5. 胶囊样式（Capsule）

头尾两端为圆弧的胶囊形进度条，中段为线性填充。

• 特性：高度大于宽度时自适应垂直显示；中段进度展示效果与线性样式一致，头尾圆弧处类似椭圆形状。
• 适用场景：需要柔和视觉效果的进度展示（如健康监测、健身应用中的进度条）。
• 示例代码：Progress({ value: 30, total: 100, type: ProgressType.Capsule }).width(150).height(60)。

6. 弧形样式（Arc）

自定义弧形进度显示，支持调整起始角度、总长度等属性。

• 特性：通过startAngle（起始角度，0~360度，以时钟0点为基线）、totalAngle（总长度，-360~360度，负数表示逆时针）等属性控制弧形形状；进度条宽度越大，越靠近圆心。
• 适用场景：自定义形状的进度展示（如仪表盘、游戏进度、技能冷却等）。
• 示例代码：Progress({ value: 70, total: 100, type: 'arc', startAngle: 180, totalAngle: 180 })（注：type也可通过字符串指定，如'arc'）。

7. Loading样式（Circular）

圆形loading进度条（JS卡片服务专用）。

• 特性：显示loading状态的圆形进度，圆点颜色可自定义。
• 适用场景：JS卡片中的加载状态提示（如新闻卡片、天气卡片的加载动画）。
• 示例代码：Progress({ type: 'circular' })（JS卡片服务中使用）。

以上格式覆盖了OpenHarmony中进度条的主要显示需求，开发者可根据场景选择合适的类型，并通过属性（如strokeWidth、color、scaleCount等）进一步自定义样式。