Apple HIG:状态组件。
适用用途
该技能提供 Apple 人机界面指南(HIG)中状态与进度类 UI 组件的指导,涉及进度指示器、状态栏和活动圆环。适用于需要就此类组件的呈现方式、时机与平台行为获取设计建议的场景。
主要原则
- 为时长超过一两秒的操作显示进度。
- 当时长或百分比已知时使用确定性指示器。填充式进度条能让用户清楚了解剩余工作量,适用于下载、上传或任何可度量的过程。
- 当时长未知时使用不确定性指示器。旋转加载图标传达工作正在进行,但不承诺完成时间,适用于不可预测的网络请求。
- 优先使用进度条而非旋转加载图标。确定性进度感觉更快、更可信。
- 将指示器放在内容将出现的位置。进度应内联在内容区域附近,而非模态或较远位置。
- 不要堆叠多个指示器。同时进行的操作应汇总为一种表示,或只展示最相关的一个。
- 不要在没有充分理由的情况下隐藏状态栏。隐藏仅保留给沉浸式体验(全屏媒体、游戏、AR)。
- 让状态栏样式与内容匹配。使用浅色或深色以获得足够对比度。
- 尊重安全区域。状态栏后方不应放置交互式内容。
- 退出沉浸式场景后及时恢复状态栏。
- 活动圆环用于 Move、Exercise 和 Stand 目标。不要把圆环隐喻改用于无关数据。
- 尊重圆环配色约定。红色(Move)、绿色(Exercise)、蓝色(Stand)与 Apple Fitness 强关联。
- 使用 HealthKit API 获取活动数据,而非手动追踪。
- 圆环闭合时通过动画和触觉反馈庆祝完成。
参考索引
- progress-indicators.md:进度条与旋转加载图标;确定性、不确定性、内联放置、时长。
- status-bars.md:iOS/iPadOS 状态栏;系统信息、可见性、样式、安全区域。
- activity-rings.md:watchOS 活动圆环;Move/Exercise/Stand、HealthKit、健身追踪、颜色。
输出格式
- 指示器类型建议及理由(确定性 vs 不确定性)。
- 时机与动画指导——时长阈值、动画风格、过渡。
- 无障碍——VoiceOver 进度播报、实时区域更新。
- 目标平台上的平台特定行为。
需要询问的问题
- 时长是已知还是未知?
- 面向哪些平台?
- 操作通常耗时多久?
- 是系统级指示器还是应用内指示器?
相关技能
- hig-components-system:显示进度或状态的组件与复杂功能。
- hig-inputs:触发进度状态的手势(下拉刷新)。
- hig-technologies:用于活动圆环数据的 HealthKit;用于进度播报的 VoiceOver。
注意事项
该技能会先检查 .claude/apple-design-context.md,复用已有上下文,并只询问尚未覆盖的信息。
由 Raintree Technology 构建 · 更多开发者工具