名称： apple-hig
描述： 遵循苹果人机界面指南（Apple Human Interface Guidelines）设计 iOS、macOS、watchOS、tvOS 和 visionOS 应用程序的专家指南。适用于构建苹果平台应用或界面、实现 SF Symbols、使用 iOS 组件进行设计、遵循无障碍指南或创建原生苹果体验的场景。涵盖设计原则、模式、组件、排版、色彩、布局、导航以及平台特定规范。

Apple 人机界面指南技能

遵循官方苹果人机界面指南（HIG）的原则、模式和最佳实践，为苹果平台设计卓越的体验。

核心设计原则

清晰度

• 文字在任何尺寸下都必须清晰易读
• 图标应精确且清晰
• 装饰元素应保持微妙且恰当
• 通过聚焦内容，使功能一目了然

谦逊

• 内容充满整个屏幕，同时界面保持不显眼
• 半透明和模糊效果暗示更多内容
• 尽量减少使用边框、渐变和阴影，保持界面轻盈通透

深度

• 视觉层次和逼真的动效传达层级与活力
• 触控与可发现性提升愉悦感
• 流畅的过渡保持空间方向感

平台特定指南

iOS / iPadOS

关键特性：
- 以触控为先的交互
- 支持纵向和横向方向
- 尊重安全区域（刘海屏、灵动岛、主屏幕指示器）
- 手势：滑动、轻点、长按、捏合、旋转

布局：
- 使用 SF Pro 字体（系统字体）
- 尊重安全区域和可读内容引导线
- 采用 自动布局 实现自适应界面
- 支持 动态类型 以提升无障碍体验

导航：
- 标签栏： 3-5 个主要目的地，始终可见
- 导航栏： 用于层级浏览，包含返回按钮
- 搜索： 当对应用体验重要时，应突出显示

完整的 iOS 模式，请参阅 references/ios.md

macOS

关键特性：
- 鼠标/触控板/键盘交互
- 可调整大小的窗口
- 屏幕顶部的菜单栏
- 用于启动应用的程序坞

布局：
- 使用 SF Pro 字体（系统字体）
- 窗口控件（关闭、最小化、缩放）位于左侧
- 侧边栏 用于导航（位于左侧边缘）
- 工具栏 用于主要操作

交互：
- 右键点击上下文菜单
- 键盘快捷键（⌘ Command 键）
- 窗口间拖放

完整的 macOS 模式，请参阅 references/macos.md

watchOS

关键特性：
- 一瞥即知的信息
- 快速交互
- 数码表冠和侧边按钮
- 支持始终显示

布局：
- SF Compact 字体（为手表优化的圆角系统字体）
- 内容延伸至边缘
- 优先采用垂直滚动

交互：
- 轻点： 主要操作
- 数码表冠： 滚动和缩放
- 用力按压：（旧款机型）上下文菜单
- 抬腕唤醒

完整的 watchOS 模式，请参阅 references/watchos.md

tvOS

关键特性：
- 10 英尺观看距离
- Siri 遥控器（方向键 + 触控板）
- 焦点驱动的导航
- 视差效果

布局：
- SF Pro 字体（系统字体）
- 大的触控目标（最小 250pt）
- 内容采用网格布局
- 焦点引擎处理导航

交互：
- 方向键： 上下左右移动焦点
- 选择（点击）： 主要操作
- 菜单键： 返回导航
- Siri： 语音命令

完整的 tvOS 模式，请参阅 references/tvos.md

visionOS

关键特性：
- 空间计算环境
- 3D 深度和窗口
- 眼动追踪 + 手势
- 沉浸式和窗口化模式

布局：
- 在 3D 空间中运用 深度和层次
- 采用具有活力效果的 玻璃材质
- 使用 SF Pro 字体（系统字体）

交互：
- 注视 + 捏合： 主要选择方式
- 手势： 轻点、拖拽、旋转
- 语音： Siri 命令
- 沉浸度调节旋钮： 控制环境融合程度

完整的 visionOS 模式，请参阅 references/visionos.md

排版

SF Symbols

• 6000+ 个 由苹果设计的图标
• 可变的字重和比例（从超细到特粗）
• 多色、层级、调色板、单色 渲染模式
• SF Symbols 6 为最新版本

用法示例：

Image(systemName: "star.fill")
Image(systemName: "heart.circle.fill")

指南：
- 使符号字重与文本字重相匹配
- 使用填充变体表示选中状态
- 利用多色传达语义含义

San Francisco (SF)

苹果的系统字体家族，针对可读性进行了优化：

• SF Pro： 用于 iOS、macOS、tvOS
• SF Compact： 用于 watchOS（圆角）
• SF Mono： 用于代码和表格数据
• SF Arabic、SF Hebrew： 本地化变体

文本样式（动态类型）：
- 大标题、标题 1/2/3
- 标题、正文、标注
- 副标题、脚注、说明文字 1/2

始终支持动态类型 以提升无障碍体验。

色彩

系统色彩

使用能自适应浅色/深色模式的语义化色彩：

• 标签： 主要文本
• 二级标签： 次要文本
• 三级标签： 禁用文本
• 系统背景： 主背景
• 系统填充： UI 元素的填充色

强调色

• 使用 强调色 表示交互元素（按钮、链接）
• 确保 足够的对比度（WCAG AA：正常文本 4.5:1）
• 在 浅色和深色模式 下进行测试

活力效果

• 材质： 模糊背景以显示深度
• 活力： 色彩能适应其背后的材质

组件

iOS 组件

按钮：
- 填充、着色、灰色、纯文本样式
- 尺寸：小、中、大
- 使用 SF Symbols 作为图标

列表：
- 内嵌分组样式（现代 iOS）
- 滑动操作（左侧/右侧）
- 上下文菜单

表单：
- 模态呈现
- 停靠点：中等、大
- 可拖拽关闭

导航：
- 大标题（iOS 11+）
- 滚动状态时使用内联标题
- 搜索栏集成

所有 iOS 组件，请参阅 references/ios-components.md

macOS 组件

窗口：
- 标准、实用工具、面板类型
- 标题栏样式：默认、透明、统一
- 侧边栏和分割视图

工具栏：
- 图标+文字或纯图标按钮
- 用于视图的段控件
- 搜索栏

所有 macOS 组件，请参阅 references/macos-components.md

布局与间距

网格系统

• 8pt 网格 作为基线（iOS、macOS）
• 边距： 16pt（iPhone）、20pt（iPad）、20pt（Mac）
• 间距： 8pt、16pt、24pt、32pt 标准增量

安全区域

• 顶部： 状态栏、刘海屏、灵动岛
• 底部： 主屏幕指示器（iPhone）、程序坞（iPad）
• 左侧/右侧： 避免将内容放置得过于靠近边缘

自适应布局

• 尺寸类别： 紧凑、常规（宽度/高度）
• 特性变化： 浅色/深色模式、动态类型尺寸
• 支持 横屏和竖屏

无障碍功能

旁白

• 提供有意义的 无障碍标签
• 对相关元素进行分组
• 确保逻辑性的 焦点顺序

动态类型

• 支持所有文本尺寸（从默认的 -3 到 +7）
• 在 无障碍尺寸（AX1-AX5）下进行测试
• 使用 可缩放的字体 和布局

色彩对比度

• WCAG AA： 正常文本 4.5:1，大文本 3:1
• WCAG AAA： 正常文本 7:1，大文本 4.5:1
• 使用 灰度 和 色盲 模式进行测试

减弱动态效果

• 为动画提供替代方案
• 当动态效果减弱时，使用 交叉渐隐 代替滑动

交互模式

手势（iOS/iPadOS）

• 轻点： 主要操作
• 长按： 上下文菜单或拖拽预览
• 滑动： 导航、删除、显示操作
• 捏合： 放大/缩小
• 旋转： 旋转内容
• 边缘滑动： 返回导航

触感反馈（iOS）

• 冲击： 物理碰撞或边界感
• 通知： 成功、警告、错误
• 选择： 选择器或开关变化

键盘快捷键（macOS/iPadOS）

• ⌘ Command： 主要操作（⌘N 新建，⌘S 保存）
• ⇧ Shift： 修改命令（⇧⌘S 另存为）
• ⌥ Option： 替代行为
• ⌃ Control： 上下文特定

动画与动效

时长

• 快速： 0.2-0.3 秒（按钮按下、小过渡）
• 标准： 0.3-0.5 秒（屏幕过渡、表单）
• 慢速： 0.5-0.8 秒（复杂、空间过渡）

缓动

• 缓入/缓出： 大多数动画的标准
• 弹性： 自然、活泼的动效
• 线性： 仅用于进度指示器

原则

• 连续性： 元素平滑过渡
• 预期性： 暗示即将发生的变化
• 跟随与重叠： 动效自然完成

深色模式

指南

• 在开发过程中 测试两种模式
• 使用 语义化色彩（系统色彩会自动适应）
• 通过微妙的色彩提升来 突出 表面（不仅仅是变亮）
• 避免使用纯黑色（#000000）—— 对于真正的黑色使用深灰色

材质

• iOS：.systemBackground、.secondarySystemBackground、.tertiarySystemBackground
• macOS：.windowBackgroundColor、.controlBackgroundColor

平台集成

iOS 特性

• 小组件： 主屏幕、锁定屏幕、待机模式
• 实时活动： 灵动岛、锁定屏幕
• App Clips： 轻量级应用体验
• 快捷指令： Siri 快捷指令集成
• App Intents： 系统级操作

macOS 特性

• 菜单栏： 全局应用菜单
• 程序坞： 带有徽章的应用图标
• 触控栏：（旧款 MacBook Pro）
• 扩展： 共享、今天、访达
• 连续互通： 接力、通用剪贴板

快速参考

资源

• iOS 模式 - 完整的 iOS 组件库
• macOS 模式 - 完整的 macOS 组件库
• watchOS 模式 - 完整的 watchOS 组件库
• tvOS 模式 - 完整的 tvOS 组件库
• visionOS 模式 - 完整的 visionOS 模式
• iOS 组件参考 - 所有 iOS UIKit/SwiftUI 组件
• macOS 组件参考 - 所有 macOS AppKit/SwiftUI 组件

基于苹果人机界面指南 - https://developer.apple.com/design/human-interface-guidelines