# Hig Components Status

> Apple HIG 状态与进度 UI 组件指南，包括进度指示器、状态栏和活动圆环。当用户要求设计进度条、加载动画、状态栏显示或活动圆环时使用。

- Skill: `kscz0000/hig-components-status` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add kscz0000/hig-components-status`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kscz0000/hig-components-status/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kscz0000 (https://skillmd.com/u/kscz0000)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/kscz0000/hig-components-status

---


# Apple HIG: 状态组件

提问前先检查 `.claude/apple-design-context.md`。使用已有上下文，仅询问未覆盖的信息。

## 核心原则

### 进度指示器

1. **超过一两秒的操作应显示进度。**

2. **时长或百分比已知时使用确定性进度。** 填充式进度条让用户清楚感知剩余工作量。适用于下载、上传或任何可量化的过程。

3. **时长未知时使用不确定性进度。** 旋转指示器传达"正在处理"但不承诺时间框架。适用于不可预测的网络请求。

4. **优先使用进度条而非旋转指示器。** 确定性进度感觉更快、更可信。

5. **将指示器放在内容即将出现的位置。** 内联进度靠近内容区域，而非模态或远处位置。

6. **不要堆叠多个指示器。** 将同时进行的操作合并为一个表示，或显示最相关的那个。

### 状态栏

7. **没有充分理由不要隐藏状态栏。** 仅在沉浸式体验（全屏媒体、游戏、AR）时隐藏。

8. **状态栏样式与内容匹配。** 浅色或深色以确保足够对比度。

9. **尊重安全区域。** 状态栏后方不要放置可交互内容。

10. **退出沉浸式场景后立即恢复状态栏。**

### 活动圆环

11. **活动圆环专用于"移动"、"锻炼"和"站立"目标。** 不要将圆环隐喻挪用于无关数据。

12. **尊重圆环颜色约定。** 红色（移动）、绿色（锻炼）、蓝色（站立）与 Apple Fitness 强关联。

13. **使用 HealthKit API** 获取活动数据，而非手动追踪。

14. **圆环闭合时用动画和触感反馈庆祝。**

## 参考索引

| 参考 | 主题 | 关键内容 |
|---|---|---|
| [progress-indicators.md](references/progress-indicators.md) | 进度条和旋转指示器 | 确定性、不确定性、内联放置、时长 |
| [status-bars.md](references/status-bars.md) | iOS/iPadOS 状态栏 | 系统信息、可见性、样式、安全区域 |
| [activity-rings.md](references/activity-rings.md) | watchOS 活动圆环 | 移动/锻炼/站立、HealthKit、健身追踪、颜色 |

## 输出格式

1. **指示器类型推荐**及理由（确定性 vs 不确定性）。
2. **时机和动画指导**——时长阈值、动画风格、过渡。
3. **无障碍**——VoiceOver 进度播报、实时区域更新。
4. **平台特定行为**跨目标平台。

## 需要询问的问题

1. 时长已知还是未知？
2. 目标平台有哪些？
3. 操作通常需要多长时间？
4. 系统级还是应用内指示器？

## 相关技能

- **hig-components-system**——显示进度或状态的小组件和复杂功能
- **hig-inputs**——触发进度状态的手势（下拉刷新）
- **hig-technologies**——HealthKit 用于活动圆环数据；VoiceOver 用于进度播报

---

*由 [Raintree Technology](https://raintree.technology) 构建 · [更多开发者工具](https://raintree.technology)*

## 使用时机
本技能适用于执行概述中描述的工作流程或操作。

## 限制
- 仅当任务明确匹配上述范围时使用本技能。
- 输出不能替代环境特定的验证、测试或专家审查。
- 若缺少必需输入、权限、安全边界或成功标准，请停止并请求澄清。