apple-design

Apple Design（Apple 人机界面指南参考技能）

此技能将 Apple 官方设计资源（developer.apple.com/design/）提炼为可直接使用的参考资料，帮助你为 iOS / iPadOS / macOS / watchOS / visionOS / tvOS 应用提供有据可依的界面设计和评审建议。

有依据，还是猜测

你提出的每一项具体主张——数值、对比度、组件的官方名称、API 名称——要么有依据，要么就是猜测：

• 有依据 — 你在此技能的 references/ 文件中读到，或刚刚查阅了官方页面。
• 猜测 — 来自训练记忆。

应明确说明猜测只是猜测，绝不要将其当作规格。HIG 几乎每年都会在 WWDC 前后更新；2025 年 6 月，Apple 用 Liquid Glass 全面替换了材料、图标和控件外观系统——因此，训练记忆中的“Apple 设计指南”很可能早于这次变更，或混杂了不同平台的规格。若某项主张无法找到依据，请如实说明，并提供官方 URL。

定性建议（例如“确保单手操作时能触及主要操作”）不需要这样处理。数值、官方名称和规格则需要。

HIG 的整体结构

官方 HIG（developer.apple.com/design/human-interface-guidelines/）分为六个顶层部分，从抽象到具体依次为：

1. 入门 — 设计原则，以及各平台概览（iOS/iPadOS/macOS/tvOS/visionOS/watchOS/游戏）
2. 基础 — 贯穿各类界面的元素：无障碍功能、App 图标、颜色、材料、排版、布局、SF Symbols、动态效果、隐私、深色模式等
3. 模式 — 常见任务和体验的设计指南：新手引导、搜索、撤销和重做、多任务处理、模态、通知等
4. 组件 — 系统组件，分为八个子类别：内容 / 布局与组织 / 菜单与操作 / 导航与搜索 / 呈现 / 选择与输入 / 状态 / 系统体验
5. 输入 — 输入方式：手势、Digital Crown、Apple Pencil、眼睛、游戏控制等
6. 技术 — 集成特定 Apple 技术：Siri、Wallet、HealthKit、SharePlay 等

完整的网站地图和每个页面的 URL 都位于 references/hig-sitemap.md。

如何使用此技能

首先确定目标平台。不同平台的人体工学、输入方式和组件惯例差异很大——在把基于 iPhone 的假设套用到 Apple Watch 或 Vision Pro 之前，请先阅读 references/platforms.md 中的相关部分。然后选择与请求相符的分支。

分支 A — 设计新内容

1. 判断这是关于基础设计，还是关于特定组件／模式的问题：
   • 颜色、字体／字号、SF Symbols、材质（尤其是 Liquid Glass）、图标、布局／安全区域、无障碍 → 查看下方参考索引中的对应文件
   • 如何使用特定控件（按钮、标签栏、侧边栏、列表、工具栏）→ references/components.md；未涵盖的内容，请在 references/hig-sitemap.md 中查找对应的 slug
   • 交互模式（引导流程、搜索、撤销、手势）→ references/patterns-gestures.md
2. 说明原因，而不只是做法。建议要以 references/principles.md 中的设计原则为依据，或引用具体的官方理由（例如“这样控件在 Apple 默认的 44×44pt 尺寸下依然易于点击”，而不是“因为 Apple 这么说”）。
3. 要制作实际设计文件或原型时，请引导用户查看 references/resources.md 中的官方 UI Kits、字体、SF Symbols 和 Icon Composer，而不是让用户从头重绘标准系统控件。

完成标准：答案中的每个数字、组件名称和 API 名称都有依据，且每条建议都说明了理由。

分支 B — 评审现有设计

按照 references/principles.md 的顺序，逐一检查全部八项原则，并为每项明确给出结论：符合／违反（指出具体元素）／不适用。然后，根据 references/accessibility.md 和 references/layout.md，核对评审实际涉及的规格——点击目标、字号、对比度、安全区域。

完成标准：八项原则都有结论——包括最终判定为良好的项目，让用户看到评审已全面完成；引用的每项规格都有依据。

分支 C — 查询一项事实

先查看下方的参考索引；其中的摘要能回答大多数问题。如果摘要没有提到所需组件，或用户需要确切的数值或 API 名称，请打开 references/hig-sitemap.md 中对应的 URL。

获取 HIG 页面：这些页面是由 JavaScript 渲染的单页应用，因此普通的 WebFetch 往往只能获取页面标题，而非正文。如果获取结果短得不太正常，请改用浏览器工具（导航 → 等待 1-2s → get_page_text）。如果仍然失败，请将 URL 提供给用户，并告知内容未能获取。

八项设计原则（速查）

完整说明见 references/principles.md；以下是每项原则的一句话版本，可用于快速判断设计权衡应偏向哪一方：

• 目标 — 在决定如何实现之前，先弄清楚对人们而言真正重要的是什么
• 自主权 — 不妨碍用户，让他们自由探索，并降低犯错的代价（撤销、恢复）
• 责任 — 对人们的数据和信任负责；透明说明权限和数据使用情况
• 熟悉感 — 借鉴人们已熟悉的概念，并保持视觉和交互一致，以降低学习成本
• 灵活性 — 无障碍设计是起点，而非补丁；要适应不同设备、输入方式和情境
• 简洁性 — 只保留必要内容，并建立清晰的层级；简洁不等于极简
• 精湛工艺 — 每个细节都体现你有多用心；不断打磨，不要把发布视作终点
• 愉悦感 — 明确想唤起什么情绪，但绝不要让愉悦感喧宾夺主，盖过当前任务

平台速查（详情见 references/platforms.md）

平台	一句话定位	主要导航	关键输入方式
iOS	随时随地、单手操作、碎片化使用	悬浮标签栏（Liquid Glass）	多点触控、语音
iPadOS	大屏生产力与创作、多任务处理	标签栏 ↔ 侧边栏，自适应	触控、外接键盘/触控板、Apple Pencil
macOS	长时间专注工作、多窗口	菜单栏 + 侧边栏	键盘、指点设备
watchOS	抬腕即看、在手腕上进行一分钟以内的交互	Digital Crown 导航	Digital Crown、操作按钮、简单手势
visionOS	空间计算、窗口悬浮于真实空间中	悬浮标签栏 / 侧边栏	眼睛 + 间接/直接手势

references/platforms.md 未概述 tvOS；如需了解 tvOS，请通过 references/hig-sitemap.md 获取 designing-for-tvos。（tvOS 规范已涵盖在辅助功能、排版和布局参考文件中。）

一段话了解 Liquid Glass

Liquid Glass 于 2025 年推出，这种新材质用于控件和导航层（标签栏、侧边栏、工具栏），而非内容层。标准系统组件会自动采用它；自定义组件应谨慎使用。它有两种样式：regular（保留易读性，适用于大多数情况）和 clear（突出显示其下方丰富媒体背景的可见度）。默认情况下，它没有固有颜色，会从背后的内容中自行着色——应谨慎使用颜色，并优先为背景而非其上方的符号/文本着色。完整规则见 references/materials-color.md。

辅助功能规范（精简版；以 references/accessibility.md 为准）

规范	iOS/iPadOS	macOS	tvOS	watchOS	visionOS
默认文本大小	17pt	13pt	29pt	16pt	17pt
最小文本大小	11pt	10pt	23pt	12pt	12pt
默认控件大小	44×44pt	28×28pt	66×66pt	44×44pt	60×60pt
最小控件大小	28×28pt	20×20pt	56×56pt	28×28pt	28×28pt
文本对比度（≤17pt）	4.5:1（WCAG AA）	同左	同左	同左	同左

默认值是设计目标；最小值是下限。 应将 44×44pt（iOS/iPadOS/watchOS）和 60×60pt（visionOS）作为控件的建议尺寸——按钮指南明确将这些尺寸规定为按钮的下限。小得多的“最小控件大小”一行是辅助功能页面给出的绝对下限；不要将其作为设计目标提供给用户。

完整的辅助功能指南（视觉、听觉、行动能力、言语、认知）见 references/accessibility.md。

参考文件索引

文件	内容
references/principles.md	对八项设计原则的完整说明，以及如何应用这些原则
references/platforms.md	iOS/iPadOS/macOS/watchOS/visionOS 的设备特性、人机工程学和最佳实践
references/materials-color.md	关于 Materials、Liquid Glass 和 Color 系统的完整规则
references/typography-symbols.md	字体系列、动态字体，以及 SF Symbols 的渲染模式、字重和动画
references/layout.md	视觉层级、尺寸类别、安全区域和适配性
references/accessibility.md	权威规范表，以及五个无障碍维度的指导
references/components.md	按钮、标签栏、侧边栏、列表/表格和工具栏的最佳实践
references/app-icons.md	分层图标设计、Icon Composer 工作流和 Liquid Glass 图标外观
references/patterns-gestures.md	手势设计原则、各平台的标准手势和常见交互模式
references/resources.md	官方 UI Kits、字体、SF Symbols、Icon Composer 和其他下载资源
references/hig-sitemap.md	HIG 的完整 URL 索引，用于查找本技能未涵盖的内容

关于引用官方内容的说明

HIG 文本受 Apple 版权保护。向用户解释时，请用自己的话转述核心规则及其理由，不要粘贴大段原文。若必须使用确切措辞（例如用于营销文案或涉及法律的内容），请将官方 URL 提供给用户，让他们自行阅读来源，而不要在回复中逐字复述。