SuperAPI AI 工具集

apply-macos-hig

设计与创作

查看项目

更新于 10-16 04:38

技能介绍

用途

该技能面向正在构建、审查或设计 macOS SwiftUI 或 AppKit 界面的开发者与设计师,提供符合 Apple 人机界面指南(HIG)的组件规格、间距值、颜色令牌等参考。其内容基于 21 份参考文档,共 13,286 行,每条论断均追溯至 Apple HIG、AppKit API 文档、SDK 头文件、WWDC 会议或经核实的实践来源。覆盖范围从 macOS Sequoia(15)到 Tahoe(26),包含 Liquid Glass、Compositional Layout、SF Symbol 效果、AutoFill/Passkeys 与窗口平铺。

主要能力

技能正文包含日常所需的关键值:间距刻度、排版尺寸、组件决策树与核心模式。详细规格需阅读参考索引中对应的参考文件。技能强调不要凭记忆猜测尺寸或行为,而应查阅参考。

核心原则

  • 三条 macOS UI 法则:每个操作必须出现在菜单栏中;标准键盘快捷键不可更改;设置立即生效,偏好设置中无保存/取消/应用按钮。
  • 间距采用 8pt 基线网格,标准值为 4pt 的倍数或约数,并给出 20-8-6 规则(20pt 窗口边距、8pt 标签到控件间距、6pt 堆叠控件最小间距)。
  • 排版方面,macOS 文本样式比 iOS 同义样式小 25-50%,正文为 13pt 而非 17pt,Headline 为粗体而非半粗体。
  • 控件尺寸分为 Mini、Small、Regular、Large 四档,并给出典型高度与用途。
  • 提供按钮类型、容器、数据展示组件、复选框与开关等决策树。
  • 窗口与工具栏模式:工具栏样式、项目排序、侧边栏规格。
  • 对话框与警告规则:按钮放置、默认按钮、取消按钮、破坏性按钮不可为默认。
  • 菜单栏要求:标准菜单顺序、设置项命名、省略号使用规则、修饰键顺序。
  • 颜色系统:标签层级、语义颜色、强调色、CALayer 刷新、资源目录颜色槽位。
  • 材质与活力:混合模式、Liquid Glass API 与变体。
  • 动效与动画:时长、曲线、减少动态效果。
  • 无障碍:标签、角色协议、装饰性图像、VoiceOver 测试。
  • SwiftUI 与 AppKit 选择建议。
  • 常见错误清单。

使用方式

实现组件或模式时:从参考索引中识别对应参考文件;阅读以获取精确尺寸、API 示例、状态与注意事项;交叉参考实践者洞察了解实际陷阱;检查无障碍参考中的无障碍要求。不要仅依赖记忆,参考文件具有权威性。

适用场景

适用于构建、审查或设计 macOS SwiftUI 或 AppKit 界面,需要 HIG 合规组件规格、间距值、颜色令牌等场景。

限制

资料未提供该技能的安装命令、收费方式、价格、平台支持范围或具体使用步骤,这些信息暂未提供。