---

name: hig-components-status description: Apple HIG关于状态和进度UI组件的指导，包括进度指示器、状态栏和活动圆环。 risk: unknown source: community date_added: '2026-02-27'

Apple HIG：状态组件

在提问之前检查.claude/apple-design-context.md。使用现有上下文，仅询问尚未涵盖的信息。

关键原则

进度指示器

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

2. 当持续时间/百分比已知时使用确定型。 填充式进度条让用户清楚了解剩余工作量。用于下载、上传或任何可测量的过程。

3. 当持续时间未知时使用不确定型。 旋转器传达正在进行工作但不承诺时间框架。用于不可预测的网络请求。

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

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

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

状态栏

1. 没有充分理由不要隐藏状态栏。 仅为沉浸式体验保留隐藏（全屏媒体、游戏、AR）。

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

3. 尊重安全区域。 状态栏后面不放置交互内容。

4. 退出沉浸式上下文时及时恢复。

活动圆环

1. 活动圆环用于运动、锻炼和站立目标。 不要将圆环隐喻用于无关数据。

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

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

4. 庆祝完成 当圆环闭合时使用动画和触觉反馈。

参考索引

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

输出格式

1. 指示器类型建议 附带理由（确定型 vs 不确定型）。
2. 时间和动画指导 -- 持续时间阈值、动画样式、过渡效果。
3. 无障碍 -- VoiceOver进度播报、实时区域更新。
4. 平台特定行为 跨目标平台。

需要询问的问题

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

相关技能

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

---

由 Raintree Technology 构建 · 更多开发者工具

何时使用

当任务明确匹配上述概述中描述的范围时，此技能适用于执行所述工作流或操作。

限制

• 仅在任务明确匹配上述描述的范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少所需输入、权限、安全边界或成功标准，请停下来寻求澄清。