技能 Apple HIG: Status Components
📦
Apple HIG: Status Components
安全
实现 Apple HIG 状态和进度组件
不确定使用进度指示器、状态栏还是活动圆环？此技能为 iOS、iPadOS、watchOS 和 macOS 上的状态和进度 UI 组件提供权威的 Apple 人机界面指南。
支持: Claude Codex Code(CC)
1
下载技能 ZIP
2
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
3
开启并开始使用
测试它
正在使用“Apple HIG: Status Components”。 5 秒的图片上传应该使用加载指示器还是进度条？
预期结果:
- 使用定量进度条进行 5 秒上传。
- 理由：定量指示器显示可测量的进度，比加载指示器感觉更快。用户可以估算剩余时间。
- HIG 参考：ProgressIndicators - "当已知时长时，优先使用定量进度指示器。"
正在使用“Apple HIG: Status Components”。 在阅读应用中隐藏状态栏可以吗？
预期结果:
- 仅在沉浸式阅读模式下隐藏状态栏，而非在整个应用中隐藏。
- 提供点击手势恢复状态栏可见性。
- 用户需要访问时间和电池状态，而无需离开您的应用。
- HIG 参考：StatusBars - "避免永久隐藏状态栏。"
安全审计
安全v1 • 2/25/2026
Static analysis detected 128 patterns but all are FALSE POSITIVES. Files are Markdown documentation referencing Apple Developer Documentation URLs. Backticks are Markdown inline code syntax (e.g., `HKActivityRingView`), not shell commands. URLs point to developer.apple.com. No executable code, network calls, or security risks exist.
3
已扫描文件
262
分析行数
0
发现项
1
审计总数
未发现安全问题
审计者: claude
质量评分
45
架构
100
可维护性
87
内容
50
社区
100
安全
65
规范符合性
你能构建什么
移动应用加载状态
为 iOS 应用中的网络操作和后台任务确定合适的进度指示器
健身应用活动追踪
实现符合 Apple HIG 的活动圆环，用于 Move、Exercise 和 Stand 目标
沉浸式媒体体验
决定何时在全屏视频、照片或游戏中隐藏或显示状态栏
试试这些提示
基本进度指示器选择
我需要显示文件下载进度。应该使用进度条还是加载指示器？下载需要 10-30 秒。
状态栏可见性决策
我正在构建一个照片查看器。什么时候应该隐藏状态栏，用户如何恢复显示？
活动圆环实现
我可以将活动圆环颜色（红色、绿色、蓝色）用于与健身追踪无关的自定义进度可视化吗？
高级多平台进度
我需要在 iOS、iPadOS 和 watchOS 上提供一致的进度反馈。对于健身应用，各平台的特定要求是什么，如何在每个平台上处理活动圆环显示？
最佳实践
- 当已知操作时长或百分比时使用定量进度条
- 将进度指示器放置在加载内容的附近，而非远处的模态对话框中
- 除了真正的沉浸式体验（如全屏视频）外，保持状态栏可见
避免
- 对已知时长的操作使用加载指示器 - 用户无法估算等待时间
- 堆叠多个进度指示器 - 汇总为单一表示
- 将活动圆环颜色或设计重新用于非健身数据 - 违反 HIG
常见问题
什么时候应该使用加载指示器而不是进度条？
当知道时长或百分比时使用进度条。仅当时长未知时使用加载指示器（不定量），例如等待没有大小信息的网络响应。
我可以自定义健身应用的活动圆环颜色吗？
不可以。活动圆环颜色是固定的：红色代表 Move，绿色代表 Exercise，蓝色代表 Stand。切勿修改这些颜色或将这些圆环用于无关数据。
在游戏中隐藏状态栏可以接受吗？
是的，对于游戏和全屏媒体等沉浸式体验，隐藏状态栏是合适的。如果用户需要查看时间，提供简单的手势来恢复显示。
如何处理多个同时下载？
避免堆叠多个指示器。显示汇总进度（合并百分比）或显示最相关操作的进度。切勿用多个加载指示器让用户感到不堪重负。
进度指示器有什么无障碍考虑？
使用实时区域通过 VoiceOver 播报进度变化。在有意义的间隔提供百分比更新，而非每次细微变化时都更新。确保足够的颜色对比度。
我可以使用活动圆环显示非健身数据（如任务完成）吗？
不可以。活动圆环仅用于 Move、Exercise 和 Stand 目标。将它们用于其他数据会混淆用户并违反 Apple HIG。请改用标准进度指示器。