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 指导。
限制
仅当任务明确符合上述范围时使用该技能。
不要将输出视为具体环境验证、测试或专家评审的替代品。
如果缺少必要的输入、权限、安全边界或成功标准,请停止并请求澄清。