SuperAPI AI 工具集

hig-components-controls

设计与创作

查看项目

更新于 10-15 18:07

技能介绍

用途

该技能提供 Apple 人机界面指南(HIG)中关于选择与输入控件的指导,用于帮助开发者在 Apple 平台界面设计中选择合适的控件,并遵循一致、可访问的交互模式。

覆盖的控件类型

资料列出以下控件及其适用场景:

  • 开关(Toggles):用于二元状态(开/关)。在设置类界面中改动立即生效;在模态表单中改动需确认后提交。
  • 分段控件(Segmented controls):用于互斥选项,通常 2–5 项、重要性大致相当、标签简短。
  • 滑块(Sliders):用于连续数值,当精确数值输入不重要时使用,应提供最小值/最大值标签或端点图标。
  • 选择器(Pickers):用于较长的选项列表,适用于日期、时间、结构化数据等。
  • 步进器(Steppers):用于小幅精确调整,以固定步长增减,需在步进器旁显示当前值并设置合理的最小/最大值。
  • 文本框(Text fields):用于短的单行输入;文本视图(Text views)用于多行输入。应根据预期输入配置键盘类型(电子邮件、URL、数字)。
  • 组合框(Combo boxes):文本输入加选择列表,仅限 macOS,可输入自定义值或从预定义列表中选择。
  • 令牌字段(Token fields):将离散值显示为可视令牌,仅限 macOS,适用于电子邮件收件人、标签或离散项集合。
  • 仪表与评分指示器:仅用于显示。仪表显示某范围内的值,评分指示器显示评分(常为星级);如需输入应使用可交互变体。

关键原则

  • 清晰呈现当前状态:用户必须始终能看到当前选中的内容。
  • 优先使用系统标准控件:内置控件提供一致性和可访问性,自定义控件会增加学习成本并可能破坏辅助功能。
  • 各类控件按其语义使用,例如开关用于二元状态、分段控件用于互斥选项。

输出格式要求

该技能规定输出应包含:控件建议及理由(并说明为何替代方案不合适)、状态管理(控件如何传达当前状态,改动是立即生效还是需确认)、验证方式(何时显示错误、如何传达规则)、无障碍(VoiceOver 的标签、特性、提示)。

需要确认的问题

  • 数据类型是什么?(布尔值、固定集合中的选择、数值、自由文本?)
  • 选项数量有多少?
  • 目标平台有哪些?(组合框和令牌字段仅限 macOS)
  • 是设置界面还是内联表单?

使用方式与限制

资料提到,在提问前应先检查 .claude/apple-design-context.md,利用已有上下文,只询问尚未涵盖的信息。该技能为设计指导性质,具体实现代码、收费与价格信息暂未提供。

相关技能

资料列出相关技能:hig-components-menus(按钮与弹出按钮)、hig-components-dialogs(包含表单的工作表与弹出框)、hig-components-search(搜索字段)、hig-inputs(键盘、指针、手势交互)、hig-foundations(排版、颜色、布局)。