关于
Apple 人机界面指南中的组件和控件设计规范。使用前先检查 .claude/apple-design-context.md 中的现有上下文。
name: hig-components-controls description: "在提问前检查 .claude/apple-design-context.md。使用现有上下文，仅询问尚未涵盖的信息。" risk: unknown source: community date_added: '2026-02-27'
Apple HIG：选择和输入控件
在提问前检查 .claude/apple-design-context.md。使用现有上下文，仅询问尚未涵盖的信息。
关键原则
-
清晰的当前状态。 用户必须始终看到选中了什么。开关显示开/关，分段控件高亮活动段，选择器显示当前选择。
-
优先使用标准系统控件。 内置控件提供一致性和无障碍性。自定义控件引入学习曲线，可能破坏辅助功能。
-
开关用于二元状态。 开或关。在设置风格的屏幕中，更改立即生效。在模态表单中，更改在确认时提交。
-
分段控件用于互斥选项。 2-5 个项目，大致相同的重要性，简短标签。
-
滑块用于连续值。 当精确数字输入不关键时。为范围端点提供最小/最大标签或图标。
-
选择器用于长选项列表。 选项太多不适合分段控件。适用于日期、时间、结构化数据。
-
步进器用于小幅精确调整。 以固定步长递增/递减。在步进器旁显示当前值，设置合理的最小/最大边界。
-
文本字段用于短的单行输入。 文本视图用于多行。配置键盘类型以匹配预期输入（邮箱、URL、数字）。
-
组合框：文本输入 + 选择列表。 macOS。当自定义值有效时，输入值或从预定义列表中选择。
-
令牌字段：作为视觉令牌的离散值。 macOS。用于邮件收件人、标签或离散项目的集合。
-
仪表和评分指示器显示值。 仪表显示范围内的值。评分指示器显示评分（通常是星星）。仅显示；使用交互变体进行输入。
参考索引
| 参考 | 主题 | 关键内容 | |---|---|---| | controls.md | 通用控件 | 状态、可供性、系统控件 | | toggles.md | 开关 | 开/关、立即生效 | | segmented-controls.md | 分段控件 | 2-5 个选项、等权重 | | sliders.md | 滑块 | 连续范围、最小/最大标签 | | steppers.md | 步进器 | 固定步长、有界值 | | pickers.md | 选择器 | 日期、时间、长选项集 | | combo-boxes.md | 组合框 | macOS、输入或选择、自定义值 | | text-fields.md | 文本字段 | 短输入、键盘类型、验证 | | text-views.md | 文本视图 | 多行、评论、描述 | | labels.md | 标签 | 放置、VoiceOver 支持 | | token-fields.md | 令牌字段 | macOS、芯片、标签、收件人 | | virtual-keyboards.md | 虚拟键盘 | 邮箱、URL、数字键盘类型 | | rating-indicators.md | 评分指示器 | 星级评分、仅显示 | | gauges.md | 仪表 | 级别指示器、范围显示 |
输出格式
- 控件推荐及理由，以及为什么替代方案不太合适。
- 状态管理 -- 控件如何传达当前状态，以及更改是立即应用还是在确认时应用。
- 验证方法 -- 何时显示错误以及如何传达规则。
- 无障碍性 -- VoiceOver 的标签、特征、提示。
需要询问的问题
- 什么类型的数据？（布尔值、从固定集合中选择、数字、自由文本？）
- 有多少选项？
- 哪些平台？（组合框和令牌字段仅限 macOS）
- 设置屏幕还是内联表单？
相关技能
- hig-components-menus -- 补充选择控件的按钮和弹出按钮
- hig-components-dialogs -- 包含表单的工作表和弹出框
- hig-components-search -- 共享文本输入模式的搜索字段
- hig-inputs -- 与控件的键盘、指针、手势交互
- hig-foundations -- 控件样式的排版、颜色、布局
由 Raintree Technology 构建 · 更多开发者工具
何时使用
本技能适用于执行概述中描述的工作流或操作。
局限性
- 仅在任务明确匹配上述范围时使用本技能。
- 不要将输出视为环境特定验证、测试或专家审查的替代品。
- 如果缺少必需的输入、权限、安全边界或成功标准，请停下来要求澄清。