kscz0000 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 构建 · 更多开发者工具
使用时机
本技能适用于执行概述中描述的工作流或操作。
限制
- 仅当任务明确匹配上述范围时使用本技能。
- 不要将输出视为环境特定验证、测试或专家审查的替代品。
- 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。