mcpField
I
ios-hig

ios-hig

github.com/johnrogers设计与 UI233267 次安装41 周前更新
代码仓库

关于 ios-hig

ios-hig 是面向 iOS 应用开发者的设计参考技能,依据 Apple 的 Human Interface Guidelines。它指导选择相关参考资料,并指出交互、无障碍、视觉设计等方面的常见问题。

主要功能

  1. 01指导选择设计参考资料
  2. 02触控目标与布局注意事项
  3. 03Dynamic Type 和 VoiceOver 无障碍支持
  4. 04对比度与 Reduce Motion 检查
  5. 05触觉反馈与状态反馈建议

适用场景

  1. 01检查 iOS 界面的无障碍设计
  2. 02审视交互与导航模式
  3. 03规划动画、反馈和配色

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/johnrogers/claude-swift-engineering --skill ios-hig

安装后在 Claude Code 中输入/ios-hig确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
accessibility.md
content.md
feedback.md
interaction.md
performance-platform.md
privacy-permissions.md
visual-design.md

详细介绍

iOS 人机界面指南

Apple 人机界面指南定义了视觉语言、交互模式和无障碍标准,让 iOS 应用呈现原生、直观的体验。核心原则:通过周到的设计实现清晰与一致。

参考资料加载指南

只要有哪怕一丝可能需要用到相关内容,就务必加载参考文件。 与其遗漏模式或犯错,不如先掌握上下文。

参考资料加载时机
交互涉及触控目标、导航、布局、层级或手势模式时
内容涉及空状态、文案撰写、排版或占位文本时
视觉设计涉及颜色、材质、对比度、深色模式或 SF Symbols 时
无障碍涉及 VoiceOver、动态字体、减少动态效果或无障碍标签时
反馈涉及动画、触觉反馈、加载状态或错误消息时
性能涉及响应速度、系统组件或应用启动时
隐私涉及权限请求、数据处理或隐私敏感型 API 时

常见错误

  1. 触控目标小于 44x44 点 — 按钮和交互元素必须至少为 44x44 点(iOS),以便拇指操作。目标过小会让用户感到挫败,也会造成无障碍体验问题。

  2. 忽视动态字体限制 — 固定字号的文本无法遵循用户的无障碍设置。请使用动态字体大小,在“大”或“特大”设置下进行测试,并避免硬编码字体大小。

  3. 深色模式下颜色对比度不足 — 在浅色模式下适用的颜色,在深色模式下可能无法满足无障碍要求。请在两种模式下启用“降低对比度”无障碍设置进行测试。

  4. 过度使用过渡动画 — 在 60fps 下看起来流畅的动画,可能会让有前庭障碍的用户感到晕动。请遵循“减少动态效果”设置,并将动画时长控制在 300ms 以内。

  5. 自定义控件缺少 VoiceOver 标签 — 自定义按钮、切换控件或交互视图需要使用 .accessibilityLabel() 和 .accessibilityHint(),否则屏幕阅读器用户将完全无法使用它们。

  6. 过度使用触觉反馈 — 并非每个操作都需要触觉反馈。请将触觉反馈留给确认操作(购买、关键操作)和错误提示。过多的触觉反馈会令人烦恼,还会消耗电池电量。

评论

支持 Markdown