apple-human-interface-guidelines

Apple Human Interface Guidelines

涵盖所有 Apple 平台的综合设计参考。适用于以下场景：

• 为任何 Apple 平台设计或评审 UI
• 遵循 Apple 惯例实现 SwiftUI 或 UIKit 组件
• 决定布局、排版、颜色、无障碍功能或交互模式
• 集成 Apple 技术（Apple Pay、HealthKit、Game Center 等）
• 将 Apple 的设计原则应用于 Web 或跨平台开发

如何使用此技能

1. 确定任务类别（平台设计、组件、模式、输入或技术）
2. 在下方找到相应的参考资料
3. 加载所需的特定参考文件
4. 对于无障碍功能、颜色、排版等跨领域事项，除组件参考资料外，还要加载相关的基础参考资料

---

快速参考：常见任务

任务	加载这些参考资料
构建登录／身份验证界面	foundations/privacy.md、technologies/sign-in-with-apple.md、patterns/managing-accounts.md
设计设置界面	patterns/patterns-settings.md、components/selection-and-input/toggles-guidelines.md
选择颜色／深色模式	foundations/color-guidelines.md、foundations/dark-mode.md
实现导航	components/navigation-and-search/tab-bars.md、components/navigation-and-search/sidebars.md、components/layout-and-organization/split-views.md
排版／文字大小	foundations/typography-guidelines.md、foundations/writing-guidelines.md
无障碍审查	foundations/accessibility.md、technologies/voiceover-guidelines.md
设计表单	patterns/entering-data.md、components/selection-and-input/text-fields.md、components/selection-and-input/pickers.md
构建列表／表格视图	components/layout-and-organization/lists-and-tables.md、components/presentation/scroll-views.md
添加搜索功能	patterns/searching-patterns.md、components/navigation-and-search/search-fields.md
创建应用图标	foundations/app-icons.md
设计通知	patterns/managing-notifications.md、components/system-experiences/notifications-component.md
构建小组件	components/system-experiences/widgets-design-guidelines.md
实现支付	technologies/apple-pay.md、technologies/in-app-purchase.md
设计图表／数据可视化	patterns/charting-data.md、components/content/components-charts.md
为 visionOS 构建应用	getting-started/designing-for-visionos.md、foundations/spatial-layout.md、foundations/immersive-experiences.md
模态呈现	patterns/modality-guidelines.md、components/presentation/sheets-guidelines.md、components/presentation/alerts-component.md
新手引导流程	patterns/onboarding.md、patterns/launching.md
视频／音频播放	patterns/playing-video.md、patterns/playing-audio.md
游戏设计	getting-started/designing-for-games.md、inputs/game-controls.md、technologies/game-center.md
RTL／国际化	foundations/right-to-left.md、foundations/inclusion-guidelines.md
分享／协作	patterns/collaboration-and-sharing.md、components/menus-and-actions/activity-views.md
生成式 AI 功能	technologies/generative-ai-guidelines.md、technologies/machine-learning-design.md

---

1. 入门 — 平台设计基础

在针对特定平台开始设计，或需要了解平台限制（屏幕尺寸、输入方式、人机工程学）时，请查阅这些内容。

参考资料	何时查阅
reference/getting-started/designing-for-ios.md	iPhone 应用设计：显示特性、人机工程学、控件布局、外观适配
reference/getting-started/designing-for-ipados.md	iPad 应用设计：大屏幕、多任务处理、多种输入模式、小组件
reference/getting-started/designing-for-macos.md	macOS 应用设计：窗口管理、菜单栏、键盘快捷键、Dock
reference/getting-started/designing-for-tvos.md	tvOS/Apple TV：8 英尺以上的观看距离、焦点系统、Siri Remote、电影式呈现
reference/getting-started/designing-for-visionos.md	visionOS/Vision Pro：空间设计、沉浸级别、眼动/手势输入、舒适度
reference/getting-started/designing-for-watchos.md	watchOS：一目了然的 UI、Digital Crown、复杂功能、始终显示
reference/getting-started/designing-for-games.md	跨平台游戏设计：文字大小、控件、入门引导、无障碍功能

2. 基础 — 跨领域设计原则

适用于各个平台的核心设计原则。其中许多也适用于Web 和跨平台开发。

普遍适用（任何平台）

参考资料	何时查阅
reference/foundations/accessibility.md	视力、听力、行动、言语、认知无障碍要求及对比度
reference/foundations/color-guidelines.md	色彩选择、主题、对比度、系统颜色规范、深色模式颜色值
reference/foundations/dark-mode.md	深色模式实现：自适应颜色、对比度（最低 4.5:1）、图标/图像适配
reference/foundations/typography-guidelines.md	字体大小、字重、行距、Dynamic Type 规范、各平台的文本样式
reference/foundations/writing-guidelines.md	UX 文案：语气/风格、按钮标签、错误消息、大小写
reference/foundations/inclusion-guidelines.md	包容性语言、多元化呈现、文化敏感性
reference/foundations/layout-guidelines.md	视觉层级、自适应布局、安全区域、设备尺寸
reference/foundations/motion-guidelines.md	动画最佳实践、无障碍功能、帧速率
reference/foundations/privacy.md	权限流程、用途说明、跟踪规则、数据保护
reference/foundations/branding-guidelines.md	品牌整合：强调色、自定义字体、徽标、内容优先设计

Apple 平台专属

参考资料	何时查阅
reference/foundations/app-icons.md	应用图标设计：图层、形状、尺寸、深色/染色样式、平台专属规范
reference/foundations/icons-guidelines.md	界面图标/字形、SF Symbol 名称映射、macOS 文稿图标
reference/foundations/images-guidelines.md	图像分辨率、缩放系数、文件格式、tvOS 分层图像
reference/foundations/sf-symbols.md	SF Symbols：渲染模式、可变颜色、字重、动画、自定义符号
reference/foundations/materials-guidelines.md	Liquid Glass、活力效果、材质厚度、平台专属材质
reference/foundations/right-to-left.md	RTL 界面：文本对齐、数字处理、控件/图像翻转
reference/foundations/spatial-layout.md	visionOS：视野、深度、中心到中心间距至少 60pt
reference/foundations/immersive-experiences.md	visionOS 沉浸体验：混合式/渐进式/全沉浸式、透视、舒适度

3. 模式 — 交互与 UX 模式

常见的 UX 模式。其中许多适用于 Apple 平台以外的场景。

数据与内容

参考资料	何时查阅
reference/patterns/charting-data.md	数据可视化：图表简洁性、无障碍访问、图表类型选择
reference/patterns/entering-data.md	表单设计：验证、安全输入、提供选项而非文本输入
reference/patterns/searching-patterns.md	搜索：字段位置、建议、隐私、Spotlight 集成
reference/patterns/file-management.md	文档应用：自动保存、快速查看、打开/保存对话框

反馈与状态

参考资料	何时查阅
reference/patterns/feedback-patterns.md	状态、错误、任务完成、警告
reference/patterns/loading-patterns.md	进度指示器、占位内容、后台下载
reference/patterns/playing-haptics.md	触觉反馈：预定义模式、自定义触觉

生命周期与导航

参考资料	何时查阅
reference/patterns/launching.md	启动屏幕（无文本/品牌标识）、状态恢复
reference/patterns/onboarding.md	首次运行：交互式引导、TipKit、权限请求时机
reference/patterns/modality-guidelines.md	模态界面用法：使用时机、关闭惯例、避免模态界面叠加
reference/patterns/going-full-screen.md	全屏模式：布局、控件可见性、手势延迟处理
reference/patterns/multitasking.md	应用切换、后台任务、多窗口

媒体

参考资料	何时查阅
reference/patterns/playing-audio.md	音频类别、中断、空间音频
reference/patterns/playing-video.md	视频播放：宽高比、画中画、系统播放器、visionOS 沉浸式视频
reference/patterns/live-viewing-apps.md	直播电视/流媒体：EPG、内容页脚、云 DVR

社交与商务

参考资料	何时查阅
reference/patterns/collaboration-and-sharing.md	分享按钮、协作弹出框、分享表单
reference/patterns/managing-accounts.md	登录流程、通行密钥、生物识别、账户删除要求
reference/patterns/managing-notifications.md	中断级别、专注模式、营销通知规则
reference/patterns/ratings-and-reviews.md	评分提示：时机、频率、系统提示

实用工具

参考资料	何时查阅
reference/patterns/drag-and-drop.md	拖放：移动/复制、视觉反馈、多项操作、无障碍访问
reference/patterns/offering-help.md	TipKit、工具提示（macOS/visionOS）、上下文帮助
reference/patterns/printing-pattern.md	打印操作的位置、macOS 打印面板自定义
reference/patterns/undo-and-redo.md	撤销/重做：多级操作、平台专用快捷键/手势
reference/patterns/patterns-settings.md	设置的位置、默认值、macOS 设置窗口
reference/patterns/workouts-pattern.md	健身/锻炼界面：训练界面、指标、活动圆环

4. 组件 — UI 构建模块

内容

参考资料	何时查阅
reference/components/content/components-charts.md	图表组件：标记类型、坐标轴、颜色、交互、无障碍访问
reference/components/content/image-views.md	图像显示：叠加层、动画、tvOS 分层、visionOS 空间效果
reference/components/content/text-views.md	多行文本视图：使用时机、易读性、编辑
reference/components/content/web-views.md	嵌入式网页内容：导航、避免复刻浏览器

布局与组织

参考资料	何时查阅
reference/components/layout-and-organization/components-boxes.md	GroupBox/NSBox：内容分组、标题、嵌套
reference/components/layout-and-organization/collections-component.md	网格/行视觉布局：图库、内边距、动态变化
reference/components/layout-and-organization/column-views.md	macOS 分栏（浏览器）视图：用于深层级结构
reference/components/layout-and-organization/disclosure-controls.md	展开控件（三角形/按钮）：可展开的分区
reference/components/layout-and-organization/components-labels.md	静态标签：颜色层级（主要→第四级）、易读性
reference/components/layout-and-organization/lists-and-tables.md	列表/表格：样式、编辑、选择、各平台规则
reference/components/layout-and-organization/lockups-tvos.md	tvOS 组合卡片：卡片、海报、焦点展开
reference/components/layout-and-organization/outline-views.md	macOS 大纲视图：分层数据、排序、展开
reference/components/layout-and-organization/split-views.md	多窗格布局：分隔线、调整大小、各平台规则
reference/components/layout-and-organization/tab-views.md	选项卡内容窗格：选项卡数量上限、标签、替代方案

菜单与操作

参考资料	何时查阅
reference/components/menus-and-actions/activity-views.md	分享表单：自定义操作、图标大小
reference/components/menus-and-actions/buttons.md	按钮设计：点击区域、样式、角色、各平台按钮类型
reference/components/menus-and-actions/context-menus.md	上下文菜单：排序、预览、破坏性操作
reference/components/menus-and-actions/dock-menus.md	macOS Dock 菜单
reference/components/menus-and-actions/edit-menus.md	编辑菜单：系统菜单与自定义菜单、各平台行为
reference/components/menus-and-actions/home-screen-quick-actions.md	iOS/iPadOS 长按快捷操作（最多 4 项）
reference/components/menus-and-actions/menus-design-guidelines.md	菜单设计：标签、图标、分组、子菜单
reference/components/menus-and-actions/ornaments-visionos.md	visionOS 装饰控件：与窗口关联的浮动控件
reference/components/menus-and-actions/pop-up-buttons.md	弹出式按钮：选择互斥选项
reference/components/menus-and-actions/pull-down-buttons.md	下拉式按钮：操作菜单、破坏性操作
reference/components/menus-and-actions/menu-bar-guidelines.md	macOS/iPadOS 菜单栏：标准菜单、必备项目、快捷键
reference/components/menus-and-actions/toolbars.md	工具栏：项目分组、溢出、导航栏

导航与搜索

参考资料	何时查阅
reference/components/navigation-and-search/path-controls.md	macOS 路径控件：标准/弹出式样式
reference/components/navigation-and-search/search-fields.md	搜索栏：位置、范围控件、标记
reference/components/navigation-and-search/sidebars.md	侧边栏：层级、显示/隐藏、各平台规则
reference/components/navigation-and-search/tab-bars.md	标签栏：标签数量、徽标、Liquid Glass、侧边栏适配
reference/components/navigation-and-search/token-fields.md	macOS 标记栏：将文本转换为标记

演示

参考资料	何时查阅
reference/components/presentation/action-sheets.md	操作表单：破坏性按钮、“取消”，以及与警告框／菜单的区别
reference/components/presentation/alerts-component.md	警告框：标题、按钮位置、破坏性样式
reference/components/presentation/page-controls.md	页面指示器：位置、交互、自定义
reference/components/presentation/panels.md	macOS 面板／HUD：浮动辅助窗口
reference/components/presentation/popovers.md	弹出框：定位、大小、关闭
reference/components/presentation/scroll-views.md	滚动视图：嵌套、分页、边缘效果、缩放
reference/components/presentation/sheets-guidelines.md	工作表：停靠点、按钮位置、抓手、模态／非模态
reference/components/presentation/windows-component.md	窗口：类型、状态、visionOS 体积、玻璃背景

选择与输入

参考资料	何时查阅
reference/components/selection-and-input/color-wells.md	颜色选取器／颜色井
reference/components/selection-and-input/combo-boxes.md	macOS 组合框
reference/components/selection-and-input/digit-entry-views.md	tvOS PIN／数字输入
reference/components/selection-and-input/image-wells.md	macOS 图像井（拖放式图像编辑）
reference/components/selection-and-input/pickers.md	选取器／日期选取器：样式、模式、各平台
reference/components/selection-and-input/segmented-controls.md	分段控件：模式、分段数量限制
reference/components/selection-and-input/sliders.md	滑块：方向、刻度线、标签、圆形滑块（macOS）
reference/components/selection-and-input/components-steppers.md	步进器：数值可见性、与文本栏配对使用
reference/components/selection-and-input/text-fields.md	文本栏：尺寸、占位符、验证、键盘类型
reference/components/selection-and-input/toggles-guidelines.md	切换控件／开关／复选框／单选按钮
reference/components/selection-and-input/virtual-keyboards.md	虚拟键盘：类型、自定义输入视图、扩展

状态

参考资料	何时查阅
reference/components/status/activity-rings.md	活动圆环：颜色、背景、标签 RGB 值
reference/components/status/gauges.md	仪表／水平指示器：样式、渐变
reference/components/status/progress-indicators.md	进度条、旋转指示器、刷新控件
reference/components/status/rating-indicators.md	星级评分（仅限 macOS）

系统体验

参考资料	何时查阅
reference/components/system-experiences/app-shortcuts.md	App Shortcuts：Siri、Spotlight、语音交互设计
reference/components/system-experiences/watchos-complications.md	watchOS 并发症：类型、图像尺寸、模板
reference/components/system-experiences/controls-system-experience.md	iOS 控件：控制中心、锁定屏幕、操作按钮
reference/components/system-experiences/live-activities.md	实时活动：结构、布局、各设备尺寸
reference/components/system-experiences/notifications-component.md	通知内容、操作（最多 4 个）、标记、watchOS 外观
reference/components/system-experiences/status-bars.md	iOS／iPadOS 状态栏：可见性、可读性
reference/components/system-experiences/top-shelf.md	tvOS Top Shelf：模板、图像尺寸
reference/components/system-experiences/watch-faces.md	watchOS 表盘：共享、并发症、预览
reference/components/system-experiences/widgets-design-guidelines.md	小组件：类型、尺寸、渲染模式、精确尺寸

5. 输入 — 交互方式

参考文档	何时查阅
reference/inputs/action-button.md	iPhone/Watch 操作按钮：标签（最多 3 个词）、行为
reference/inputs/apple-pencil-and-scribble.md	Apple Pencil：悬停、轻点两下、捏合、随手写、PencilKit
reference/inputs/camera-control.md	iPhone 16 相机控制：叠层、取景器布局
reference/inputs/digital-crown.md	数码表冠：watchOS 滚动/导航、visionOS 系统用途
reference/inputs/visionos-eyes-input.md	visionOS 视线：悬停效果、间距（中心间距 60pt）、舒适度
reference/inputs/focus-and-selection.md	焦点导航：iPadOS、tvOS（5 种状态）、visionOS
reference/inputs/game-controls.md	游戏输入：触控、游戏控制器、键盘、visionOS 空间输入
reference/inputs/gestures.md	各平台的手势规范、自定义手势、visionOS 直接/间接交互
reference/inputs/gyro-and-accelerometer.md	动作感应：权限说明、辅助功能
reference/inputs/keyboards-guidelines.md	物理键盘快捷键、修饰键、完整键盘访问
reference/inputs/nearby-interactions.md	超宽带近距离感应/空间感知
reference/inputs/pointing-devices.md	指针/鼠标/触控板：效果、点击区域、磁吸效果
reference/inputs/remotes-tvos.md	Siri Remote：手势、按钮行为、焦点集成

6. 技术 — 平台集成

支付与商务

参考文档	何时查阅
reference/technologies/apple-pay.md	Apple Pay：按钮类型/样式/尺寸、结账、订阅
reference/technologies/in-app-purchase.md	IAP：订阅注册、优惠码、退款、家人共享
reference/technologies/tap-to-pay-on-iphone.md	Tap to Pay：商家流程、结账体验、错误处理

身份与隐私

参考文档	何时查阅
reference/technologies/sign-in-with-apple.md	使用 Apple 登录：按钮规范（最小 140×30pt）、自定义按钮、用户体验流程
reference/technologies/id-verifier.md	ID Verifier：年龄/身份验证、数据最小化
reference/technologies/wallet-design-guidelines.md	Wallet 凭证：样式、图像规范、订单跟踪、身份

健康与健身

参考文档	何时查阅
reference/technologies/healthkit-guidelines.md	HealthKit：隐私、活动圆环规则、健康图标使用
reference/technologies/carekit.md	CareKit：任务视图、图表、联系人、护理计划
reference/technologies/researchkit.md	ResearchKit：引导流程顺序、调查问卷、主动任务

媒体与通信

参考文档	何时查阅
reference/technologies/airplay-guidelines.md	AirPlay：流播放、镜像、图标规范、术语
reference/technologies/shareplay.md	SharePlay：活动共享、visionOS Persona 模板
reference/technologies/live-photos.md	Live Photos：帧调整、共享、徽章
reference/technologies/shazamkit.md	ShazamKit：麦克风隐私、iCloud 选择加入
reference/technologies/imessage-apps-and-stickers.md	iMessage 应用/贴纸：视图、图标/贴纸尺寸、格式

AI 与机器学习

参考文档	何时查阅
reference/technologies/generative-ai-guidelines.md	生成式 AI：透明度、隐私、减少幻觉
reference/technologies/machine-learning-design.md	ML 用户体验：反馈、校准、置信度、修正

平台扩展

参考资料	何时查阅
reference/technologies/app-clips.md	App Clips：卡片规格、代码尺寸、隐私限制
reference/technologies/mac-catalyst.md	Mac Catalyst：iPad→Mac 适配、设备类型选择、导航映射
reference/technologies/carplay-design-guidelines.md	CarPlay：布局规格、图标尺寸、音频行为
reference/technologies/siri-integration-guidelines.md	Siri/Shortcuts：意图、语音 UX、快捷指令短语、自定义 UI

无障碍

参考资料	何时查阅
reference/technologies/voiceover-guidelines.md	VoiceOver：替代文本标签、图像描述、阅读顺序、转子

其他集成

参考资料	何时查阅
reference/technologies/always-on-display.md	Always On：隐私遮蔽、调暗、布局一致性
reference/technologies/augmented-reality.md	AR/ARKit：物体放置、引导叠层、多用户
reference/technologies/game-center.md	Game Center：访问入口、成就、排行榜、图像规格
reference/technologies/homekit-guidelines.md	HomeKit：术语、设置流程、Siri 模式、品牌规范
reference/technologies/icloud-guidelines.md	iCloud：同步、冲突解决、存储、游戏存档
reference/technologies/maps-guidelines.md	MapKit：标注、叠层、聚类、地点卡片
reference/technologies/nfc-guidelines.md	NFC：扫描 UX、术语、后台标签读取
reference/technologies/photo-editing-extensions.md	照片编辑扩展：工具栏、预览、取消确认

---

跨平台适用性

这些参考资料包含适用于 Apple 平台以外（Web、Android、跨平台）的原则：

• 无障碍（foundations/accessibility.md、technologies/voiceover-guidelines.md）——对比度、屏幕阅读器模式、认知方面的考量
• 颜色与深色模式（foundations/color-guidelines.md、foundations/dark-mode.md）——主题、对比度、自适应设计
• 排版（foundations/typography-guidelines.md）——层级、尺寸、动态字体概念
• 文案（foundations/writing-guidelines.md）——UX 文案、错误消息、语气
• 包容性（foundations/inclusion-guidelines.md）——包容性语言、形象呈现
• 隐私（foundations/privacy.md）——权限模式、数据最小化
• 动态效果（foundations/motion-guidelines.md）——动画无障碍、减少动态效果
• 布局（foundations/layout-guidelines.md）——响应式／自适应模式、视觉层级
• 生成式 AI（technologies/generative-ai-guidelines.md）——负责任的 AI 设计原则
• ML 设计（technologies/machine-learning-design.md）——置信度显示、纠正模式
• 模式——大多数模式（引导、反馈、加载、模态、搜索、设置、数据输入）都蕴含着普适的 UX 经验