SuperAPI AI 工具集

macos-design

设计与创作

查看项目

更新于 10-15 21:10

技能介绍

macos-design 将 Apple Human Interface Guidelines 整理为可执行的规则,并配有 SwiftUI 与 AppKit 示例,面向使用 SwiftUI 或 AppKit 开发 macOS 应用的开发者。

用途:在构建 Mac 应用时,指导菜单栏、工具栏、窗口管理、侧边栏、键盘快捷键和指针交互的实现,使应用符合 Mac 用户对深度键盘控制、持久菜单栏、可调整多窗口布局和系统集成的预期。

主要能力与规则要点:

  1. 菜单栏(关键):每个 Mac 应用必须有菜单栏,至少包含 App、File、Edit、View、Window、Help;每个执行动作的菜单项都应有键盘快捷键;菜单项需随状态动态更新(禁用、改标题、勾选);所有交互元素应提供右键上下文菜单;App 菜单需保留 About、设置(Cmd+,)、服务、隐藏、退出等标准项;命令名称与位置应保持稳定。
  2. 窗口(关键):主窗口可自由调整大小并设置合理最小尺寸;支持原生全屏与 Split View;除单一用途工具外应支持多窗口,文档型应用用 DocumentGroup;标题栏显示文档信息并支持代理图标拖拽与编辑状态;记住窗口位置与大小;不得隐藏或移动红黄绿交通灯按钮。
  3. 工具栏(高):采用统一标题栏与工具栏样式;允许用户自定义工具栏项;用分段控件切换视图;搜索框置于工具栏尾部;工具栏项应同时提供 SF Symbol 图标与文字标签。
  4. 侧边栏(高):置于左侧、可折叠并持久化折叠状态;内容库导航使用 source list 样式;层级内容用大纲视图;支持拖拽排序;用 .badge() 显示未读等计数。
  5. 键盘(关键):鼠标可达的动作都应有键盘等价;支持 Tab 与方向键完整导航;Esc 取消或关闭;Return 触发默认按钮;Delete 删除选中项并支持 Cmd+Z 撤销;空格触发 Quick Look;方向键在列表与网格中移动选择。
  6. 指针与鼠标(高):所有交互元素需有可见悬停状态,并响应点击、右键与拖拽。

使用方式:资料以规则加代码示例的形式给出,示例使用 SwiftUI 的 .commands、WindowGroup、NavigationSplitView、.toolbar、.searchable、.listStyle(.sidebar)、.quickLookPreview 等修饰符,以及 AppKit 的 NSMenu、NSWindow、validateMenuItem、setFrameAutosaveName 等 API。开发者可对照规则在项目中实现相应行为。

适用场景:开发 macOS 原生应用、将现有应用适配 Mac 交互习惯、审查 Mac 应用是否符合 HIG。

限制:资料未提供安装命令、收费或价格信息、平台版本要求、效果数据,也未说明该技能的具体分发与集成方式,这些内容暂未提供。