Back to Details

hig

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Human Interface Guidelines Reference

人机界面指南参考文档

Local greppable copy of Apple's Human Interface Guidelines — an on-demand fact lookup, not design direction.
Use it to answer factual questions: what a system component can do, what Apple calls something, accessibility and ergonomic minimums (44pt hit targets, Dynamic Type behavior, contrast), and conventions App Review actually checks.
Visual design in our repos is the designing model's own taste. Consult the HIG for facts, never for aesthetics — it describes what the system provides and requires, not what your screen should look like.
Apple人机界面指南的本地可grep检索副本——用于按需查询事实，而非提供设计方向。
可用于解答以下事实类问题：系统组件的功能、Apple对特定元素的命名、无障碍设计与人体工学最低要求（44pt点击目标、Dynamic Type行为、对比度），以及App审核实际会检查的规范。
我们代码库中的视觉设计仅代表设计模型自身风格。 请仅参考HIG获取事实信息，切勿将其作为美学依据——它描述的是系统提供的功能和要求，而非你的界面应有的外观。

Downloaded Reference Files

已下载的参考文件

All key HIG documentation is available locally (grep-friendly):
所有核心HIG文档均已本地存储（支持grep检索）：

Getting Started

入门指南

FileContentSize
hig-index.mdFull HIG table of contents11KB
designing-for-ios.mdiOS design principles5KB
文件内容大小
hig-index.mdHIG完整目录11KB
designing-for-ios.mdiOS设计原则5KB

Foundations

基础设计

FileContentSize
app-icons.mdApp icon design guidelines14KB
color.mdColor usage and system colors17KB
typography.mdFonts, text styles, Dynamic Type17KB
layout.mdLayout principles, safe areas21KB
materials.mdMaterials, blur effects, vibrancy14KB
motion.mdAnimation principles9KB
accessibility.mdAccessibility best practices19KB
sf-symbols.mdSF Symbols usage21KB
文件内容大小
app-icons.mdApp图标设计指南14KB
color.md色彩使用与系统颜色17KB
typography.md字体、文本样式、Dynamic Type17KB
layout.md布局原则、安全区域21KB
materials.md材质、模糊效果、动态视觉效果14KB
motion.md动画原则9KB
accessibility.md无障碍设计最佳实践19KB
sf-symbols.mdSF Symbols使用规范21KB

Patterns

设计模式

FileContentSize
onboarding.mdOnboarding flows6KB
modality.mdModal presentations7KB
launching.mdApp launch experience6KB
feedback.mdUser feedback patterns5KB
playing-haptics.mdHaptic feedback10KB
searching.mdSearch patterns7KB
settings.mdSettings patterns7KB
文件内容大小
onboarding.md引导流程6KB
modality.md模态展示7KB
launching.mdApp启动体验6KB
feedback.md用户反馈模式5KB
playing-haptics.md触觉反馈10KB
searching.md搜索模式7KB
settings.md设置页面模式7KB

Components - Navigation

组件 - 导航

FileContentSize
tab-bars.mdTab bar design11KB
navigation-bars.mdNavigation bar patterns17KB
toolbars.mdToolbar design17KB
sidebars.mdSidebar patterns8KB
文件内容大小
tab-bars.md标签栏设计11KB
navigation-bars.md导航栏模式17KB
toolbars.md工具栏设计17KB
sidebars.md侧边栏模式8KB

Components - Presentation

组件 - 展示

FileContentSize
sheets.mdSheet presentations11KB
alerts.mdAlert dialogs10KB
action-sheets.mdAction sheets4KB
menus.mdMenu design14KB
文件内容大小
sheets.md表单页展示11KB
alerts.md警告对话框10KB
action-sheets.md操作表单4KB
menus.md菜单设计14KB

Components - Controls

组件 - 控件

FileContentSize
buttons.mdButton styles and usage17KB
lists-and-tables.mdList and table patterns9KB
toggles.mdToggle/switch design9KB
pickers.mdPicker controls6KB
sliders.mdSlider controls6KB
steppers.mdStepper controls2KB
text-fields.mdText input fields6KB
文件内容大小
buttons.md按钮样式与使用规范17KB
lists-and-tables.md列表与表格模式9KB
toggles.md开关控件设计9KB
pickers.md选择器控件6KB
sliders.md滑块控件6KB
steppers.md步进器控件2KB
text-fields.md文本输入框6KB

Searching the Docs

文档检索

bash
undefined
bash
undefined

Find color guidance

查找色彩相关指南

grep -i "semantic" color.md
grep -i "semantic" color.md

Find button styles

查找按钮样式

grep -i "bordered" buttons.md
grep -i "bordered" buttons.md

Find haptic patterns

查找触觉反馈模式

grep -i "notification" playing-haptics.md
grep -i "notification" playing-haptics.md

Browse the full HIG index

浏览完整HIG目录

grep -i "navigation" hig-index.md
undefined
grep -i "navigation" hig-index.md
undefined

Fetching More Docs

获取更多文档

  1. Search this skill's local 
    .md
    files first.
  2. If the topic is not here, check the other installed Apple skills you have available by their names, descriptions, or 
    SKILL.md
    frontmatter, then grep their local files. This is faster and uses less context than fetching new docs from the internet.
  3. If no installed skill has the page, use the relevant Human Interface Guidelines path with the 
    sosumi.ai
    Markdown mirror. For example, 
    /design/human-interface-guidelines/buttons
    maps to 
    https://sosumi.ai/design/human-interface-guidelines/buttons
    .
  1. 优先检索本技能本地的 
    .md
    文件。
  2. 如果所需主题未包含在此处，请查看你已安装的其他Apple技能的名称、描述或 
    SKILL.md
    前置内容，然后检索它们的本地文件。这比从互联网获取新文档更快，且占用更少上下文资源。
  3. 如果已安装的技能中没有相关页面，请使用对应的人机界面指南路径访问 
    sosumi.ai
    的Markdown镜像。例如，
    /design/human-interface-guidelines/buttons
    对应 
    https://sosumi.ai/design/human-interface-guidelines/buttons
    。

Common HIG Doc Paths

常见HIG文档路径

TopicURL Path
Full Index
human-interface-guidelines
iOS Design
human-interface-guidelines/designing-for-ios
iPadOS Design
human-interface-guidelines/designing-for-ipados
macOS Design
human-interface-guidelines/designing-for-macos
App Icons
human-interface-guidelines/app-icons
Color
human-interface-guidelines/color
Typography
human-interface-guidelines/typography
Layout
human-interface-guidelines/layout
Accessibility
human-interface-guidelines/accessibility
SF Symbols
human-interface-guidelines/sf-symbols
Buttons
human-interface-guidelines/buttons
Tab Bars
human-interface-guidelines/tab-bars
Navigation Bars
human-interface-guidelines/navigation-bars
Sheets
human-interface-guidelines/sheets
Alerts
human-interface-guidelines/alerts
主题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

Quick Facts

快速事实

System Button Styles (iOS)

iOS系统按钮样式

What the system provides out of the box:
  • Plain - Text only, minimal visual weight
  • Gray - Gray background
  • Tinted - Tinted background with accent color
  • Filled - Solid background
  • Bordered - Outlined with border
  • Bordered Prominent - Filled background, high prominence
系统默认提供的按钮样式：
  • Plain - 仅含文本，视觉权重极低
  • Gray - 灰色背景
  • Tinted - 带有强调色的背景
  • Filled - 纯色背景
  • Bordered - 带边框的轮廓样式
  • Bordered Prominent - 纯色背景，高视觉突出度

Haptic Feedback Types

触觉反馈类型

  • Selection - Light tap for selection changes
  • Impact - Light/medium/heavy/rigid/soft for collisions
  • Notification - Success/warning/error for outcomes
  • Selection - 轻量点击，用于选择变更场景
  • Impact - 轻/中/重/刚性/软性反馈，用于碰撞场景
  • Notification - 成功/警告/错误反馈，用于结果提示

Safe Areas (ergonomic facts)

安全区域（人体工学事实）

  • Content outside safe areas can be clipped by the notch/Dynamic Island, home indicator, or rounded corners
  • Interactive elements outside safe areas may be unreachable or intercepted by system gestures
  • Backgrounds can extend edge-to-edge without those risks
  • 安全区域外的内容可能会被刘海/Dynamic Island、Home指示器或圆角裁切
  • 安全区域外的交互元素可能无法被触及，或被系统手势拦截
  • 背景可延伸至全屏，不会存在上述风险

Sources

参考来源

Apple Documentation

Apple官方文档

WWDC Sessions

WWDC大会Session