Spinbutton
数值微调输入
`spinbutton` 是 ARIA 对数值范围控件的正式名称。用户通常可以直接输入数值,也可以逐步增加或减少。数字步进器只是它常见的一种外观。
生活中的例子
实验室人员把温度设为 37.5°C。向上键增加 0.5,Page Up 增加 5,数值会停在验证过的 45°C 上限。粘贴无效文本时会显示错误,不会悄悄改成别的值。
主要部分
- 01可编辑数值
- 02增减控件
- 03范围与步长
什么时候用
当用户常要按固定步长调整数值,也需要直接输入时,可以使用。这个数值必须有清楚的上下限。
什么时候不要用
只有加减按钮,不代表它就是 `spinbutton`。没有上下限的数值、很长的选项列表,或普通输入框更清楚的任务,都不适合使用。
代码里的名称
input[type=number] or role=spinbutton with valuemin/valuemax/valuenow 上线前要检查
每个字段都要有程序能读到的标签。关联提示与错误,并保留已输入内容。检查自动填充、键盘顺序、验证时机、提交状态、失败恢复、缩放与多语言。
预期结果:使用 数值微调输入 (Spinbutton) 解决这项需求,同时保留用户当前的操作上下文。 用户场景:实验室人员把温度设为 37.5°C。向上键增加 0.5,Page Up 增加 5,数值会停在验证过的 45°C 上限。粘贴无效文本时会显示错误,不会悄悄改成别的值。 建议界面模式:数值微调输入 (Spinbutton)。 适用理由:当用户常要按固定步长调整数值,也需要直接输入时,可以使用。这个数值必须有清楚的上下限。 不应使用的情况:只有加减按钮,不代表它就是 `spinbutton`。没有上下限的数值、很长的选项列表,或普通输入框更清楚的任务,都不适合使用。 产品要求:定义默认、加载、没有内容、错误、成功与恢复状态。保留用户已输入的内容,每个操作后都提供清楚反馈。 无障碍与韧性:使用结构正确的 HTML(语义化 HTML)和完整键盘操作。焦点要清楚可见,布局缩放后仍要好用。也要提供减少动态效果。遵守项目现有规则。除非项目已采用,否则不要新增界面组件库。 验收标准:主要任务可只用键盘完成,在 320px 宽度也能正常使用。焦点与状态变化可被辅助工具读出。加载、失败、重试、取消与减少动态效果都已验证。 证据与限制(证据边界):标准只涵盖列出的范围,不会替你决定外观、产品做法或 Vibulary 的教学示例。 待确认:产品文字、数据来源、分析事件、支持设备与语言,以及平台特有限制。
检查这份需求
请 AI 编程助手检查当前如何使用 数值微调输入 (Spinbutton)。 定义:`spinbutton` 是 ARIA 对数值范围控件的正式名称。用户通常可以直接输入数值,也可以逐步增加或减少。数字步进器只是它常见的一种外观。 生产环境检查:每个字段都要有程序能读到的标签。关联提示与错误,并保留已输入内容。检查自动填充、键盘顺序、验证时机、提交状态、失败恢复、缩放与多语言。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。