hig-components-controls

Apple HIG：选择与输入控件

在提问之前，先检查 .claude/apple-design-context.md。使用已有上下文，只询问尚未涵盖的信息。

关键原则

1. 清晰呈现当前状态。 用户必须始终能看到当前选中了什么。开关显示开/关，分段控件高亮当前分段，选择器显示当前选择。

2. 优先使用标准系统控件。 内置控件提供一致性和可访问性。自定义控件会带来学习成本，并可能破坏辅助功能。

3. 开关用于二元状态。 开或关。在“设置”风格的界面中，更改立即生效。在模态表单中，更改在确认时提交。

4. 分段控件用于互斥选项。 2-5 个选项，重要性大致相当，标签简短。

5. 滑块用于连续值。 当精确的数值输入并不关键时使用。为范围端点提供最小值/最大值标签或图标。

6. 选择器用于较长的选项列表。 选项太多，不适合用分段控件。适用于日期、时间、结构化数据。

7. 步进器用于小幅、精确的调整。 按固定步长递增/递减。在步进器旁显示当前值，并设置合理的最小值/最大值边界。

8. 文本字段用于简短的 单行输入。 文本视图用于多行。配置键盘类型以匹配预期的输入（email、URL、数字）。

9. 组合框：文本输入 + 选择列表。 macOS。当自定义值有效时，可输入值或从预定义列表中选择。

10. 令牌字段：将离散值表示为可视化令牌。 macOS。用于 email 收件人、标签或离散项的集合。

11. 仪表和评分指示器显示值。 仪表显示某个范围内的值。评分指示器显示评分（通常是星形）。仅用于显示；如需输入，请使用可交互的变体。

参考索引

参考	主题	关键内容
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	虚拟键盘	email、URL、数字键盘类型
rating-indicators.md	评分指示器	星形评分，仅用于显示
gauges.md	仪表	水平指示器、范围显示

输出格式

1. 控件推荐及理由，以及为什么替代方案不太合适。
2. 状态管理——控件如何传达当前状态，以及更改是立即应用还是在确认时应用。
3. 验证方式——何时显示错误，以及如何传达规则。
4. 可访问性——VoiceOver 的标签、特征、提示。

要问的问题

1. 什么类型的数据？（布尔值、从固定集合中选择、数值、自由格式文本？）
2. 有多少个选项？
3. 哪些平台？（组合框和令牌字段仅限 macOS）
4. 设置界面还是内联表单？

相关技能

• hig-components-menus -- 与选择控件相辅相成的按钮和弹出式按钮
• hig-components-dialogs -- 包含表单的工作表和弹出框
• hig-components-search -- 使用相同文本输入模式的搜索字段
• hig-inputs -- 与控件进行键盘、指针和手势交互
• hig-foundations -- 控件样式的排版、颜色和布局

---

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