Communitygithub.com

HIG组件

苹果人机界面指南中所有UI组件、模式、输入和技术的简明参考——涵盖按钮、工具栏、标签栏、侧边栏、搜索、表单、警报、弹出框、菜单等。用于选择合适的组件、设计流程或检查平台规范。

HIG组件 是什么?

该技能为开发者(如使用Claude Code、Cursor、Codex等AI agent的用户)提供了苹果人机界面指南(HIG)中所有组件、模式、输入和技术的深入摘要。它覆盖了8大类内容:菜单与操作、导航与搜索、呈现方式、选择与输入、布局与组织、内容与状态、系统体验、以及25个设计模式和13种输入方式,还有29项技术(如Apple Pay、HealthKit、CarPlay等)。每个条目都包含具体的平台差异、大小、计数和持续时间等关键值,并直接链接到Apple官方文档。使用时,只需根据路由表找到对应的参考文件,即可快速获取标准组件推荐、平台差异、以及何时使用、何时不使用的重要指导。该技能强调使用标准组件而非自定义组件,并提供了“硬性禁止”清单(如禁止复制Apple标志、滥用Activity rings等),帮助开发者避免常见错误,确保应用的可用性和平台一致性。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Sthitapragna-009/liqui-hig/tree/HEAD/skills/hig-components

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

HIG组件、模式、输入与技术

对苹果《人机界面指南》中“组件”(8组64页)、“模式”(25个)、“输入”(13种)和“技术”(29项)的转述摘要(附链接),同步于2026-11-17。未复制苹果原文;每个条目均链接至其来源。

如何使用本技能

  1. 在下文路由表中找到正确的文件,仅阅读该文件(内容较长)。
  2. 回答时说明:应该使用什么、何时不应使用、平台差异,以及具体数值(尺寸、数量、持续时间)。引用Apple链接。
  3. 推荐标准组件优先于自定义组件——标准组件免费获得Liquid Glass、无障碍、本地化和平台行为。
  4. 关于颜色、字体、布局、动效和无障碍的基础知识,请使用hig-foundations。若需构建玻璃效果本身(Web、Figma、SwiftUI),请使用liquid-glass-web。若需审计,请使用hig-review。
主题阅读文件
按钮、工具栏、菜单、上下文菜单、编辑菜单、弹出/下拉按钮、分享面板、菜单栏、装饰、快捷操作references/menus-and-actions.md
标签栏、侧边栏、搜索字段、范围栏和标记、标记字段、路径控件references/navigation-and-search.md
警报、操作列表、表单和卡扣、弹出框、页面控件、滚动视图和滚动边缘效果、面板、窗口references/presentation.md
分段控件、滑块、切换器、步进器、选择器和日期选择器、文本字段、键盘、组合框、颜色/图像井references/selection-and-input.md
框、集合、列表和表格、标签、展开控件、拆分视图、大纲/列视图、标签视图、组合控件references/layout-and-organization.md
图表(标记、坐标轴、无障碍)、图像/文本/web视图、仪表、进度指示器、活动圆环、评分指示器references/content-and-status.md
实时活动和灵动岛、小组件、通知、控件、应用快捷方式、片段、复杂功能、表盘、状态栏、顶架references/system-experiences.md
全部25个模式:图表数据、反馈、加载、启动、引导、模态、多任务、搜索、设置、撤销、拖拽、输入数据、账户、通知、音频、触觉、视频、打印、评分、健身…references/patterns.md
手势、指针和iPad指针效果、键盘快捷键、焦点、眼睛、数字表冠、操作按钮、相机控制、Apple Pencil、游戏控制、遥控器、运动传感器、邻近交互references/inputs.md
AirPlay、始终显示、App Clips、应用内购买、Apple Pay、AR、CareKitreferences/technologies-a.md
CarPlay、Game Center、生成式AI、HealthKitreferences/technologies-b.md
HomeKit、iCloud、身份验证器、iMessage、实况照片、Mac Catalyst、机器学习、地图、NFC、照片编辑、ResearchKit、SharePlay、ShazamKit、Sign in with Apple、Siri、轻点支付、VoiceOver、钱包references/technologies-c.md

快速决策表

需要……使用不使用
切换应用分区标签栏(iPhone底部,iPad顶部;可自适应为侧边栏)分段控件、工具栏
对当前视图执行操作工具栏(≤3组,一个.prominent尾部操作)标签栏
切换紧密相关的子视图分段控件(iPhone上≤5项)标签栏
关键、可操作的中断警报(≤3个按钮,动词具体,操作勿用“确定”)弹出框、通知
对用户已开始的操作进行选择操作列表(破坏性操作置顶,取消置底)警报、菜单
限定范围的任务表单(取消+完成 或 返回+完成;中/大卡扣)嵌套模态
小而临时的选项,锚定于控件弹出框(仅宽布局)iPhone上的弹出框
持续、有时限的状态实时活动(≤8小时;紧凑/最小/展开/锁定屏幕)重复通知
可瞥视的周期性信息小组件实时活动
在小空间中互斥选项弹出按钮下拉按钮
与按钮相关的操作下拉按钮(≥3项)弹出按钮
列表行中开关开关列表外的开关(改用切换按钮)
范围内的数值仪表(标准或容量)活动圆环(保留用途)
已知持续时间的进度确定进度条或圆环旋转指示器

硬性禁止清单

  • 禁止重绘Apple的标记或按钮:Apple Pay按钮/标记、Sign in with Apple、添加到Apple钱包、AirPlay/HomeKit/Apple Health图标、AR字形、App Clip码、活动圆环。请使用Apple的API或官方下载。
  • 禁止将活动圆环(或类似的三环图形)用于除运动/站立/锻炼之外的任何场景。
  • 禁止隐藏或禁用标签;禁止将破坏性按钮设为主要/默认;禁止同时显示多个警报。
  • 禁止在实时活动、小组件、App Clips或Siri响应中显示广告。
  • 禁止将时效性通知用于营销。
  • 禁止预填密码或在Sign in with Apple后询问密码。
  • 禁止未经确认即使用生成式AI自动执行不可逆操作。

相关技能