
关于
Apple HIG 展示组件指南,包括警告框、操作表、弹出框、Sheet 和数字输入视图。
name: hig-components-dialogs description: Apple HIG 关于展示组件的指南,包括警告框、操作表单、弹出框、表单和数字输入视图。 risk: unknown source: community date_added: '2026-02-27'
Apple HIG:展示组件
在提问之前,请先检查 .claude/apple-design-context.md。使用现有上下文,仅询问尚未涵盖的信息。
核心原则
-
警告框:谨慎使用,仅用于关键情况。 需要关注的错误、破坏性操作确认或需要确认的信息。它们会中断流程并要求响应。
-
表单:保持上下文的聚焦任务。 从边缘滑入(或在 macOS 上附加到窗口)。用于创建项目、编辑设置、多步骤表单。
-
弹出框:在 iPad 和 Mac 上为非模态。 出现在触发元素旁边,点击外部即可关闭。用于提供额外信息、选项或控件,而不占据整个屏幕。
-
操作表单:在多个操作中选择。 当需要从多个操作中选择时使用,特别是当其中一个是破坏性操作时。iPhone:从底部滑出。iPad:以弹出框形式出现。
-
最小化中断。 在使用模态之前,考虑内联展示或使操作可撤销。
-
简洁、可操作的警告文本。 简短的描述性标题。如需要可添加简短的消息正文。按钮标签应为具体动词("删除"、"保存"),而非"确定"。
-
明确标记破坏性操作。 破坏性按钮样式(红色文本)。将破坏性按钮放在用户不太可能反射性点击的位置。
-
提供取消选项,用于具有多个操作的警告框和操作表单。在操作表单中,取消按钮出现在底部,与其他按钮分隔。
-
数字输入:聚焦且无障碍。 适当大小的输入字段、数字间自动前进、支持粘贴和自动填充。
-
根据平台调整展示方式。 同一交互在 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 构建 · 更多开发者工具
何时使用
当任务明确匹配概述中描述的工作流程或操作时,适用此技能。
限制
- 仅在任务明确匹配上述描述的范围时使用此技能。
- 不要将输出视为特定环境验证、测试或专家审查的替代品。
- 如果缺少所需的输入、权限、安全边界或成功标准,请停下来并要求澄清。