关于 hig
hig 是 Apple 人机界面指南的本地可搜索参考资料,供开发者查询系统界面、无障碍、人体工学和审核规范等事实信息。它提供 Markdown 文档供查阅,不规定视觉设计方向。
主要功能
- 01本地可搜索的 HIG 文档
- 02查询系统组件与规范
- 03无障碍和人体工学事实
- 04App Review 规范参考
适用场景
- 01核对最小触控目标尺寸
- 02查询 Dynamic Type 和对比度
- 03查找系统控件指南
- 04确认 App Review 规范
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ prisma-labs-dev/ apple-skills --skill hig安装后在 Claude Code 中输入/hig确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
accessibility.mdaccessibility.videos.mdaction-sheets.mdactivity-views.mdalerts.mdalerts.videos.mdapp-icons.mdapp-icons.videos.mdbuttons.mdbuttons.videos.mdcharts.mdcolor.mddesigning-for-ios.mdfeedback.mdhig-index.mdhome-screen-quick-actions.mdlaunching.mdlayout.mdlists-and-tables.mdmaterials.mdmaterials.videos.mdmenus.mdmodality.mdmotion.mdnavigation-bars.mdonboarding.mdpickers.mdplaying-haptics.mdplaying-haptics.videos.mdpopovers.md详细介绍
人机界面指南参考
Apple 人机界面指南的本地可搜索副本——用于按需查询事实,而非提供设计方向。
可用它回答事实性问题:系统组件能做什么、Apple 如何称呼某项功能、无障碍与人体工学最低标准(44pt 点击目标、动态字体行为、对比度),以及 App Review 实际检查的规范。
我们代码库中的视觉设计由设计模型自行决定。 查询 HIG 了解事实,切勿将其作为美学依据——它描述的是系统提供和要求的内容,而不是你的屏幕应该是什么样子。
已下载的参考文件
所有重要的 HIG 文档均可在本地查阅(便于 grep 搜索):
入门
| 文件 | 内容 | 大小 |
|---|---|---|
| hig-index.md | 完整的 HIG 目录 | 11KB |
| designing-for-ios.md | iOS 设计原则 | 5KB |
基础
| 文件 | 内容 | 大小 |
|---|---|---|
| app-icons.md | App 图标设计指南 | 14KB |
| color.md | 颜色用法与系统颜色 | 17KB |
| typography.md | 字体、文本样式、动态字体 | 17KB |
| layout.md | 布局原则、安全区域 | 21KB |
| materials.md | 材质、模糊效果、活力效果 | 14KB |
| motion.md | 动画原则 | 9KB |
| accessibility.md | 无障碍最佳实践 | 19KB |
| sf-symbols.md | SF Symbols 用法 | 21KB |
模式
| 文件 | 内容 | 大小 |
|---|---|---|
| onboarding.md | 引导流程 | 6KB |
| modality.md | 模态呈现 | 7KB |
| launching.md | App 启动体验 | 6KB |
| feedback.md | 用户反馈模式 | 5KB |
| playing-haptics.md | 触觉反馈 | 10KB |
| searching.md | 搜索模式 | 7KB |
| settings.md | 设置模式 | 7KB |
组件 - 导航
| 文件 | 内容 | 大小 |
|---|---|---|
| tab-bars.md | 标签栏设计 | 11KB |
| navigation-bars.md | 导航栏模式 | 17KB |
| toolbars.md | 工具栏设计 | 17KB |
| sidebars.md | 侧边栏模式 | 8KB |
组件 - 呈现
| 文件 | 内容 | 大小 |
|---|---|---|
| sheets.md | 工作表呈现 | 11KB |
| alerts.md | 提醒对话框 | 10KB |
| action-sheets.md | 操作表单 | 4KB |
| menus.md | 菜单设计 | 14KB |
组件 - 控件
| 文件 | 内容 | 大小 |
|---|---|---|
| buttons.md | 按钮样式与用法 | 17KB |
| lists-and-tables.md | 列表与表格模式 | 9KB |
| toggles.md | 切换控件设计 | 9KB |
| pickers.md | 选择器控件 | 6KB |
| sliders.md | 滑块控件 | 6KB |
| steppers.md | 步进器控件 | 2KB |
| text-fields.md | 文本输入框 | 6KB |
搜索文档
# Find color guidance
grep -i "semantic" color.md
# Find button styles
grep -i "bordered" buttons.md
# Find haptic patterns
grep -i "notification" playing-haptics.md
# Browse the full HIG index
grep -i "navigation" hig-index.md
获取更多文档
- 首先搜索此技能的本地
.md文件。 - 如果这里没有相关主题,请根据名称、描述或
SKILL.mdfrontmatter 检查你能使用的其他已安装 Apple 技能,然后 grep 搜索其本地文件。这比从互联网获取新文档更快,也占用更少的上下文。 - 如果没有已安装的技能包含该页面,请使用相关的人机界面指南路径和
sosumi.aiMarkdown 镜像。例如,/design/human-interface-guidelines/buttons对应https://sosumi.ai/design/human-interface-guidelines/buttons。
常见 HIG 文档路径
| 主题 | URL 路径 |
|---|---|
| 完整索引 | human-interface-guidelines |
| iOS 设计 | human-interface-guidelines/designing-for-ios |
| iPadOS 设计 | human-interface-guidelines/designing-for-ipados |
| macOS 设计 | human-interface-guidelines/designing-for-macos |
| App 图标 | human-interface-guidelines/app-icons |
| 颜色 | human-interface-guidelines/color |
| 排版 | human-interface-guidelines/typography |
| 布局 | human-interface-guidelines/layout |
| 辅助功能 | human-interface-guidelines/accessibility |
| SF Symbols | human-interface-guidelines/sf-symbols |
| 按钮 | human-interface-guidelines/buttons |
| 标签栏 | human-interface-guidelines/tab-bars |
| 导航栏 | human-interface-guidelines/navigation-bars |
| 工作表 | human-interface-guidelines/sheets |
| 提醒 | human-interface-guidelines/alerts |
快速了解
系统按钮样式(iOS)
系统开箱即提供以下样式:
- Plain - 仅含文本,视觉效果简约
- Gray - 灰色背景
- Tinted - 带强调色的着色背景
- Filled - 实色背景
- Bordered - 带边框的轮廓样式
- Bordered Prominent - 填充背景,视觉强调度高
触觉反馈类型
- Selection - 选择变化时的轻触反馈
- Impact - 碰撞时的轻度/中度/重度/刚性/柔和反馈
- Notification - 针对结果的成功/警告/错误反馈
安全区域(人体工学要点)
- 安全区域外的内容可能被刘海屏/灵动岛、主屏幕指示器或圆角裁切
- 安全区域外的交互元素可能无法触及,或被系统手势拦截
- 背景可以延伸至屏幕边缘,不会带来上述风险
来源
Apple 文档
WWDC 专题
评论
支持 Markdown