关于 ios-hig
ios-hig 是面向 iOS 应用开发者的设计参考技能,依据 Apple 的 Human Interface Guidelines。它指导选择相关参考资料,并指出交互、无障碍、视觉设计等方面的常见问题。
主要功能
- 01指导选择设计参考资料
- 02触控目标与布局注意事项
- 03Dynamic Type 和 VoiceOver 无障碍支持
- 04对比度与 Reduce Motion 检查
- 05触觉反馈与状态反馈建议
适用场景
- 01检查 iOS 界面的无障碍设计
- 02审视交互与导航模式
- 03规划动画、反馈和配色
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ johnrogers/ claude-swift-engineering --skill ios-hig安装后在 Claude Code 中输入/ios-hig确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/accessibility.mdcontent.mdfeedback.mdinteraction.mdperformance-platform.mdprivacy-permissions.mdvisual-design.md详细介绍
iOS 人机界面指南
Apple 人机界面指南定义了视觉语言、交互模式和无障碍标准,让 iOS 应用呈现原生、直观的体验。核心原则:通过周到的设计实现清晰与一致。
参考资料加载指南
只要有哪怕一丝可能需要用到相关内容,就务必加载参考文件。 与其遗漏模式或犯错,不如先掌握上下文。
| 参考资料 | 加载时机 |
|---|---|
| 交互 | 涉及触控目标、导航、布局、层级或手势模式时 |
| 内容 | 涉及空状态、文案撰写、排版或占位文本时 |
| 视觉设计 | 涉及颜色、材质、对比度、深色模式或 SF Symbols 时 |
| 无障碍 | 涉及 VoiceOver、动态字体、减少动态效果或无障碍标签时 |
| 反馈 | 涉及动画、触觉反馈、加载状态或错误消息时 |
| 性能 | 涉及响应速度、系统组件或应用启动时 |
| 隐私 | 涉及权限请求、数据处理或隐私敏感型 API 时 |
常见错误
-
触控目标小于 44x44 点 — 按钮和交互元素必须至少为 44x44 点(iOS),以便拇指操作。目标过小会让用户感到挫败,也会造成无障碍体验问题。
-
忽视动态字体限制 — 固定字号的文本无法遵循用户的无障碍设置。请使用动态字体大小,在“大”或“特大”设置下进行测试,并避免硬编码字体大小。
-
深色模式下颜色对比度不足 — 在浅色模式下适用的颜色,在深色模式下可能无法满足无障碍要求。请在两种模式下启用“降低对比度”无障碍设置进行测试。
-
过度使用过渡动画 — 在 60fps 下看起来流畅的动画,可能会让有前庭障碍的用户感到晕动。请遵循“减少动态效果”设置,并将动画时长控制在 300ms 以内。
-
自定义控件缺少 VoiceOver 标签 — 自定义按钮、切换控件或交互视图需要使用
.accessibilityLabel()和.accessibilityHint(),否则屏幕阅读器用户将完全无法使用它们。 -
过度使用触觉反馈 — 并非每个操作都需要触觉反馈。请将触觉反馈留给确认操作(购买、关键操作)和错误提示。过多的触觉反馈会令人烦恼,还会消耗电池电量。