hig-components-status
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseApple HIG: Status Components
Apple HIG：状态组件
Check for before asking questions. Use existing context and only ask for information not already covered.
.claude/apple-design-context.md提问前请查看文件。请利用现有上下文，仅询问未涵盖的信息。
.claude/apple-design-context.mdKey Principles
核心原则
Progress Indicators
进度指示器
-
Show progress for operations longer than a second or two.
-
Determinate when duration/percentage is known. A filling progress bar gives users a clear sense of remaining work. Use for downloads, uploads, or any measurable process.
-
Indeterminate when duration is unknown. A spinner communicates work is happening without promising a timeframe. Use for unpredictable network requests.
-
Prefer progress bars over spinners. Determinate progress feels faster and more trustworthy.
-
Place indicators where content will appear. Inline progress near the content area, not modal or distant.
-
Don't stack multiple indicators. Aggregate simultaneous operations into one representation or show the most relevant.
-
对于耗时超过一两秒的操作，需显示进度。
-
当已知时长/百分比时，使用确定型指示器。 填充式进度条能让用户清晰了解剩余工作量。适用于下载、上传或任何可量化的流程。
-
当时长未知时，使用不确定型指示器。 旋转器可告知用户当前正在处理任务，但不承诺完成时间。适用于不可预测的网络请求。
-
优先使用进度条而非旋转器。 确定型进度会让用户感觉速度更快、更可信。
-
将指示器放置在内容即将出现的位置。 内联进度需靠近内容区域，而非使用模态框或放置在远处。
-
不要堆叠多个指示器。 将同时进行的操作合并为一个进度展示，或仅显示最相关的那个。
Status Bars
状态栏
-
Don't hide the status bar without good reason. Reserve hiding for immersive experiences (full-screen media, games, AR).
-
Match status bar style to your content. Light or dark for adequate contrast.
-
Respect safe areas. No interactive content behind the status bar.
-
Restore promptly when exiting immersive contexts.
-
若无充分理由，请勿隐藏状态栏。 仅在沉浸式体验（全屏媒体、游戏、AR）中才隐藏状态栏。
-
状态栏样式需与内容匹配。 选择浅色或深色样式以保证足够的对比度。
-
遵循安全区域规范。 状态栏后方不得放置可交互内容。
-
退出沉浸式场景后，需立即恢复状态栏。
Activity Rings
活动圆环
-
Activity rings are for Move, Exercise, and Stand goals. Don't repurpose the ring metaphor for unrelated data.
-
Respect ring color conventions. Red (Move), green (Exercise), blue (Stand) are strongly associated with Apple Fitness.
-
Use HealthKit APIs for activity data rather than manual tracking.
-
Celebrate completions with animation and haptics when rings close.
-
活动圆环仅用于Move、Exercise和Stand目标。 请勿将圆环隐喻用于无关数据。
-
遵循圆环颜色惯例。 红色（Move）、绿色（Exercise）、蓝色（Stand）与Apple Fitness深度关联。
-
使用HealthKit APIs获取活动数据，而非手动追踪。
-
当圆环闭合时，通过动画和触觉反馈庆祝目标达成。
Reference Index
参考索引
| Reference | Topic | Key content |
|---|---|---|
| progress-indicators.md | Progress bars and spinners | Determinate, indeterminate, inline placement, duration |
| status-bars.md | iOS/iPadOS status bar | System info, visibility, style, safe areas |
| activity-rings.md | watchOS activity rings | Move/Exercise/Stand, HealthKit, fitness tracking, color |
| 参考文档 | 主题 | 核心内容 |
|---|---|---|
| progress-indicators.md | 进度条与旋转器 | 确定型、不确定型、内联放置、时长 |
| status-bars.md | iOS/iPadOS状态栏 | 系统信息、可见性、样式、安全区域 |
| activity-rings.md | watchOS活动圆环 | Move/Exercise/Stand、HealthKit、健身追踪、颜色 |
Output Format
输出格式
- Indicator type recommendation with rationale (determinate vs indeterminate).
- Timing and animation guidance -- duration thresholds, animation style, transitions.
- Accessibility -- VoiceOver progress announcements, live region updates.
- Platform-specific behavior across targeted platforms.
- 指示器类型建议及理由（确定型 vs 不确定型）。
- 时机与动画指南——时长阈值、动画样式、过渡效果。
- 无障碍设计——VoiceOver进度播报、实时区域更新。
- 平台特定行为——跨目标平台的差异。
Questions to Ask
需询问的问题
- Is the duration known or unknown?
- Which platforms?
- How long does the operation typically take?
- System-level or in-app indicator?
- 操作时长是否已知？
- 针对哪些平台？
- 该操作通常耗时多久？
- 是系统级还是应用内指示器？
Related Skills
相关技能
- hig-components-system -- Widgets and complications displaying progress or status
- hig-inputs -- Gestures triggering progress states (pull-to-refresh)
- hig-technologies -- HealthKit for activity ring data; VoiceOver for progress announcements
Built by Raintree Technology · More developer tools
- hig-components-system —— 显示进度或状态的小组件与复杂控件
- hig-inputs —— 触发进度状态的手势（下拉刷新）
- hig-technologies —— 用于活动圆环数据的HealthKit；用于进度播报的VoiceOver