SuperAPI AI 工具集

hig-components-controls

设计与创作

查看项目

更新于 10-16 08:23

技能介绍

该技能面向遵循 Apple 人机界面指南(HIG)进行界面设计的开发者,聚焦于选择与输入类控件。使用前会先检查 .claude/apple-design-context.md,优先复用已有上下文,只询问尚未覆盖的信息。

主要能力与控件指导:

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

核心原则:清晰呈现当前状态,用户必须始终看到已选内容;优先使用标准系统控件以保证一致性与无障碍性;自定义控件会增加学习成本并可能破坏辅助功能。

输出格式:给出控件推荐及理由,并说明为何替代方案不太合适;说明状态管理方式(控件如何传达当前状态、更改是立即生效还是确认后生效);说明验证方式(何时显示错误、如何传达规则);说明无障碍支持(VoiceOver 的标签、特征、提示)。

使用时会询问的问题:数据类型(布尔、固定集合选择、数值、自由文本)、选项数量、目标平台(组合框和令牌字段仅限 macOS)、界面类型(设置界面还是内联表单)。

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

限制:组合框与令牌字段仅适用于 macOS;具体平台版本、收费与价格信息暂未提供。