SuperAPI AI 工具集

macos-design-guidelines

设计与创作

查看项目

更新于 10-16 03:05

技能介绍

用途:在构建 macOS 应用(SwiftUI 或 AppKit)时,按 Apple 人机界面指南实现菜单栏、工具栏、窗口管理、键盘快捷键与指针交互,帮助应用符合 Mac 用户的使用预期。

主要能力:

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

使用方式:资料以规则加 SwiftUI/AppKit 代码示例的形式给出,例如用 .commands 添加菜单命令、用 CommandGroup 扩展标准菜单、用 Settings 场景接入 Cmd+,、用 NavigationSplitView 构建侧边栏、用 .toolbar 与 .windowToolbarStyle(.unified) 配置工具栏、用 .frame(minWidth:minHeight:) 设置窗口最小尺寸、用 window.setFrameAutosaveName 保存窗口状态。

适用场景:开发或审查 macOS 原生应用界面,尤其是需要深度键盘控制、持久菜单栏、可缩放多窗口与系统紧密集成的专业工具类应用。

限制:资料未提供该技能的安装方式、收费信息、支持平台版本或效果保证;示例代码为节选,完整内容需查阅原始资料。