SuperAPI AI 工具集

hig-components-dialogs

设计与创作

查看项目

更新于 10-16 02:04

技能介绍

Apple HIG:呈现类组件

使用前先检查 .claude/apple-design-context.md,并优先使用已有上下文,只询问尚未覆盖的信息。

关键原则

警报(Alerts):谨慎使用,仅用于关键情境,例如需要关注的错误、破坏性操作的确认,或必须让用户知晓的信息。它们会打断流程并要求用户作出响应。

表单(Sheets):用于在保持上下文的同时完成聚焦任务。从边缘滑入(在 macOS 上附着于窗口)。适用于创建项目、编辑设置、多步骤表单。

弹出框(Popovers):在 iPad 和 Mac 上为非模态。出现在触发元素旁边,点击外部即关闭。用于在不占据整个屏幕的前提下提供附加信息、选项或控件。

操作表(Action sheets):用于在多个操作之间选择。当需从多个操作中挑选时呈现,尤其当其中一个是破坏性操作时。iPhone 从底部滑出;iPad 以弹出框形式呈现。

尽量减少打断。在选择模态呈现之前,先考虑内联呈现,或让该操作可撤销。

警报文本简洁、可操作。标题简短描述性。如有需要,正文简短。按钮标签应为具体动词(如“删除”“保存”),而非“OK”。

清晰标记破坏性操作。使用破坏性按钮样式(红色文字)。把破坏性按钮放在用户不易条件反射点击的位置。

包含多个操作的警报和操作表应提供取消选项。在操作表上,取消位于底部并与其他选项分隔。

数字输入:聚焦且可访问。输入字段尺寸合适,数字之间自动前进,支持粘贴与自动填充。

按平台适配呈现方式。同一交互在 iPhone、iPad、Mac 和 visionOS 上可能使用不同组件。

参考索引

参考|主题|关键内容

alerts.md|警报|按钮顺序、标题/正文文本、确认、破坏性操作

action-sheets.md|操作表|多个操作、取消选项、破坏性处理

popovers.md|弹出框|非模态、点击外部关闭、iPad/Mac

sheets.md|表单|模态任务、上下文保持

digit-entry-views.md|数字输入|PIN 输入、自动填充、自动前进

输出格式

推荐的呈现类型及理由,并说明为何其他替代方案不太合适。

内容规范——按 Apple 的语气与简洁规则给出标题、正文、按钮标签。

关闭行为——用户如何关闭,以及关闭后发生什么(保存、丢弃、取消)。

替代方案——说明该场景何时可能根本不需要模态(内联反馈、撤销、渐进披露)。

需要询问的问题

该呈现需要传达什么信息或操作?

是阻塞还是非阻塞?

涉及哪些平台?

出现频率如何?

相关技能

hig-components-menus——触发呈现的按钮与工具栏项

hig-components-controls——表单与弹出框中的输入控件

hig-components-search——呈现视图中的搜索与导航

hig-patterns——模态、打断、用户流程管理

hig-foundations——呈现类组件的颜色、排版、布局

由 Raintree Technology 构建 · 更多开发者工具

何时使用

该技能适用于执行上述概述中描述的工作流或操作。

示例

用户请求:

使用 @hig-components-dialogs 完成此任务:为警报、操作表、弹出框、表单和数字输入视图等呈现类组件提供 Apple HIG 指导。

限制

仅当任务明确符合上述范围时使用该技能。

不要将输出视为具体环境验证、测试或专家评审的替代品。

如果缺少必要的输入、权限、安全边界或成功标准,请停止并请求澄清。