NumberInput 组件契约¶
契约概览¶
| 领域 | 契约 |
|---|---|
| 公共契约 | NumberInput 是一个受控数字字段,具备 Field props、size、status、min、max、step、isIntegerOnly、formatValue、units、entryErrorBehavior、onEntryErrorChange、步进器、滚轮步进、清除、禁用和只读状态,以及 input-family 部件 props。 |
| 行为 | 一个由文本支持的 spinbutton;键入的草稿在失焦或按 Enter 时提交,按区域设置解析并被钳制到范围内。方向键、滚轮以及可用的非粗指针步进器按网格步进,并立即提交。 |
| 最终用户影响 | 粗指针用户直接输入数字,而不是使用紧凑步进器。键盘步进仍然可用。被拒绝的输入会显示消息并播报,绝不在尚未完成时播报;禁用字段仍可到达;只读状态不播报。 |
| 构建者影响 | 数字回调保持不变,现有 NumberInput 调用无需源代码或配置迁移;entryErrorBehavior 和 onEntryErrorChange 是可选的新的 props。 |
| 兼容性/就绪度 | 粗指针适配是非破坏性的:数值、验证、直接输入和键盘步进仍然受支持。只读暴露和减少动画的清除按钮差距仍列在 Current-state impact 下。 |
| 审查检查 | 拒绝:粗指针步进器、在要求提供非粗指针步进器时缺失、每次按键 onChange、无法解析的提交、偏离网格或超出范围的步进、使字段离开 Tab 顺序或提交的禁用字段,或 IME 组合输入期间的步进。 |
| 治理规则 | FR5 和 AR4 负责指针条件化的步进器可用性;family:input-fields FR3、FR4、FR8–FR11;spec:AST-085 FR1–FR3、FR6;spec:AST-086 FR3、FR4;spec:AST-017 FR1、FR3、FR7;architecture:internationalization;design:reduced-motion DR1。 |
此表是审查投影;以下正文为权威内容。
意图¶
NumberInput 收集一个数字。它负责区域感知解析、草稿与提交策略、范围钳制、步进、格式化显示,以及数字字段在 family:input-fields 下对 Field 和 InputGroup 的适配。消费者用法位于 NumberInput.doc.mjs 中。
兼容性与迁移¶
- 已发布默认行为保留:
yes;step={1}、滚轮步进开启、无步进器、无清除、size="md"、statusVariant="attached"、entryErrorBehavior行为等同于'complete',即已发布行为。 - 兼容性类别:非破坏性呈现适配;公共 prop 名称、类型、导出、数值和回调、验证、直接输入以及键盘步进在
spec:AST-017FR3 的数字步进器呈现规则下保持不变;entryErrorBehavior是新增的(FR14、spec:AST-117);未完成的草稿不显示拒绝,无法解析的草稿在失焦时保留,而表单仍提交已提交的数字(FR6),拒绝会显示消息(FR15、FR16):这是一个随补丁发布的无障碍行为修复(spec:AST-017FR53、spec:AST-118);onEntryErrorChange是新增的。 - 受控/非受控行为:仅受控;
value(number、null或undefined)是已提交值,NumberInput 仅保留自己的未提交文本草稿。 - 迁移决策:调用方无需进行源代码或配置迁移;数字输入功能仍可通过直接输入和键盘步进使用,同时紧凑的视觉步进辅助会根据指针精度进行适配。
消费者迁移说明属于消费者文档和发布说明。
所有权边界¶
拥有
- 由文本支持的 spinbutton 及其数字 ARIA 值。
- 区域感知解析、草稿有效性,以及提交、清除或还原的决策。
- 通过键盘、滚轮和步进器进行步进,以及步进网格。
- 静止时的格式化显示及其提交的表单值。
- 单位文本、无效输入播报和步进器。
- 步进器图标的
numberInput:stepperDown扩展键,由architecture:icon-resolution-and-component-slots交给 NumberInput。 - 禁用、禁用原因和只读行为;
number-input目标;其分组适配。
不拥有 / 非目标
- 标签、描述、标签图标、标签提示、状态消息位置和
width—— 由family:input-fields下的 Field 拥有(共享所有者部分)。 - 清除按钮自身的渲染和工具提示 —— 由共享清除控件拥有(
family:input-fieldsFR11)。 - InputGroup 行的几何结构 —— 由
family:input-fields下的 InputGroup 拥有(共享所有者部分)。 isLoading和changeAction—— 不提供(family:input-fieldsAV5)。- 解析器和提交辅助函数 —— 内部实现;其他组件会复用它们,但它们不公开。
公共概念¶
| 概念 | 封闭取值或状态 | 含义 | 按变体/方向/状态的可用性 | 默认值 | 所有者 | 稳定性 | 无效值行为 |
| Range | min、max,均可选 | 提交将钳制到的包含边界。 | 始终。 | 无边界 | component:NumberInput | 稳定 | min 大于 max(经整数舍入后):没有任何数字提交;Enter 和 blur 保留所有草稿,并以 outOfRange 拒绝。 |
| Step | 正有限数 | 步进增量。 | 方向键、滚轮、步进器。 | 1 | component:NumberInput | 稳定 | 缺失、非正、非有限或(仅整数)小数的步长将变为 1。 |
| Integer only | 关、开 | 仅解析和提交整数。 | 始终。 | 关 | component:NumberInput | 稳定 | 小数草稿无效。 |
| Draft | 无、有效、无效 | 未提交的键入文本。 | 编辑期间。 | 无 | component:NumberInput | 稳定 | 不适用。 |
| entry error behavior | complete、blur-or-enter | 在何时显示其自身的拒绝。 | 键入的草稿。 | 最近 FormLayout 的默认值,否则为 complete | spec:AST-117 | 稳定 | TypeScript 会拒绝其他值。 |
| Clearable | 关、开 | 值是否可能变为 null。 | 开启时,将 onChange 扩展为接受 null。 | 关 | component:NumberInput | 稳定 | 不适用。 |
| Entry error | NumberInputEntryError | 向应用暴露的拒绝结果。 | 通过 onEntryErrorChange。 | null | spec:AST-118 | 提议 | 类型:unreadable、fractional(仅整数)、outOfRange(min 大于 max)。 |
| Size | sm、md、lg | 控件高度。 | 始终。 | 继承的大小,否则为 md | family:input-fields | 稳定 | TypeScript 会拒绝其他值。 |
行为与布局契约¶
| ID | 不变式 | 依据 |
|---|---|---|
| FR1 | 输入是一个原生文本输入,带有 role="spinbutton";inputMode 在仅整数时为 numeric,否则为 decimal;aria-valuemin 和 aria-valuemax 取自范围;aria-valuenow 取自已提交的 value;当提供了 formatValue 时,aria-valuetext 设置为格式化后的值。 |
当前测试 |
| FR2 | 输入时只修改草稿;onChange 在输入期间不会被调用。当草稿能按当前语言环境解析(分组符号、小数点、数字书写系统和符号)、满足仅整数要求,并且字段的 min 不高于其 max 时,该草稿才有效;超出常规范围的数字是有效的,并会在提交时被钳制到范围内(FR3)。无效草稿按 FR15 所述显示其拒绝信息,通过一个持久性的断言区域显示,该区域不显示任何状态。 |
spec:AST-086 FR3;architecture:internationalization;当前测试 |
| FR3 | 在失焦时,草稿只解析一次:空草稿会清除(当可清除且存在值时调用 onChange(null))或还原,然后草稿结束;无法解析或类型错误的草稿,或当 min 高于 max 时的任何数字,都会保留在字段中并显示其拒绝信息(FR15);否则数字被钳制到范围内,当与 value 不同时通过 onChange(number) 提交,然后草稿结束。回车以相同方式解析有效草稿,并在可清除时清除空草稿。对于没有 hasClear 的空草稿,回车不提交任何内容,该草稿保留在字段中且不会标记为无效;对于无法解析或类型错误的草稿,或当 min 高于 max 时的任何草稿,回车也不提交任何内容,这些草稿保留在字段中并显示其拒绝信息(FR15)。只有当提交被钳制时,回车才会结束草稿。在未禁用的字段中,合成事件之外的每次回车都会调用 onEnter,无论它提交了什么。如果调用方在与任何保留拒绝信息的回车或失焦相同的更新中传入新的 value(正如 Table 的内联过滤器在恢复其值时所做的那样),它不会替换保留的草稿,因此被拒绝的文本及其消息会保留;之后新的 value 才会替换它(FR6)。 |
当前测试;spec:AST-118 FR4 |
| FR4 | 未带修饰键的 ArrowUp 和 ArrowDown、聚焦输入框上的滚轮(当 isWheelEnabled 启用时)以及步进器都按一个网格位置步进并立即提交。网格从 min(当它适合仅整数模式时)或 0 开始。从空字段或清空后的草稿开始,向上到达 min 或 0,向下到达 max 或 0。结果四舍五入到步长与网格起点精度中更精细者(最多 12 位小数),并限制在范围内,且绝不会脱离仅整数模式;无法移动的步进器不执行任何操作,而无法移动的箭头或滚轮步进仍会结束草稿:提交有效草稿中的数字,丢弃无法解析的草稿。调用者的 onKeyDown 若阻止了箭头按键,则取消该步进。滚轮步进会阻止页面滚动;否则页面会滚动。 |
当前测试 |
| FR5 | 启用 hasNumberSteppers 时,递增和递减按钮渲染在控件末尾,除非主指针为粗指针。在粗主指针下,这些按钮在所有视口宽度下都会从布局和无障碍树中隐藏,且没有退出选项;控件恢复其正常的主题化末尾内边距。直接数字输入和键盘步进仍然可用。显示时,按钮位于 Tab 键顺序之外,以本地化的递增和递减短语及标签命名,按下时将焦点保持在输入框上,并在通过该方式步进无法移动或字段被禁用/只读时暴露 aria-disabled。使用鼠标或触控笔按住步进器会重复步进,首次重复在 0.5 秒后发生,之后更快;每个重复值都显示为字段的草稿,当按住状态通过释放或指针取消结束时,字段通过 onChange 提交一次。单击会立即步进并提交。 |
spec:AST-085 FR1, FR2;当前测试 |
| FR6 | 使用 formatValue 时,输入框在静止状态下显示格式化后的已提交值,在聚焦时显示普通的区域设置格式数字。使用 formatValue 时,表单值通过一个携带原始已提交数字的隐藏输入框提交,可见输入框没有 name。没有 formatValue 时,可见输入框携带 name,表单提交其文本,包括按 Enter 提交的草稿;而失焦会保留被拒绝的草稿(FR3、FR15),同时一个隐藏输入框携带 name,其值为字段在最新稳定版本上显示已提交数字的形式(未聚焦时为普通数字,聚焦时为普通的区域设置格式数字),可见输入框则不携带 name,直到用户编辑草稿或新的 value 替换该值(spec:AST-118 FR4)。 |
当前测试;spec:AST-118 FR4 |
| FR7 | units 在输入框之后以次要文本形式渲染,并且是输入框描述的一部分。 |
当前测试 |
| FR8 | 使用 hasClear 时,当 value 不为 null 且字段可编辑时,会显示一个清除按钮。激活它会调用 onChange(null)、丢弃草稿,并将焦点聚焦到输入框,如同 TextInput 的清除行为。该清除按钮是一个幽灵样式的小号 component:Button,因此在减少动态效果(design:reduced-motion DR1)下,其按压缩放 MUST NOT 生效。实现缺口:在减少动态效果下它仍会缩放。 |
family:input-fields FR11;当前测试 |
| FR9 | 当 NumberInput 自身的 isDisabled 为 true,或其所处 InputGroup 的 isDisabled 为 true 时,NumberInput 将被禁用;已启用的组永远不会重新启用一个自行禁用的字段(spec:AST-085 FR7)。禁用时:输入框带有 aria-disabled="true" 和 readOnly、保留 Tab 停留点、不提交值、不提交草稿(进行中的草稿将被丢弃)、无法通过任何途径步进、除 focus 和 blur 外不触发调用方处理器、Enter 被取消、清除按钮隐藏、控件变暗,并显示键盘焦点环。使用 disabledMessage 时,在悬停和键盘聚焦时会打开原因提示框,并描述该输入框。 |
spec:AST-085 FR1–FR3、FR6;family:input-fields FR4;当前测试 |
| FR10 | 只读:readOnly、完全不透明、仍会提交、不可编辑,且无法通过键盘、滚轮或步进器进行步进;此时滚轮将改为滚动页面。当两者同时设置时,Disabled 优先。 |
当前测试 |
| FR11 | 属于 IME 组合过程的箭头键和 Enter 键既不会步进也不会提交。 | 当前测试 |
| FR12 | Field 组合、InputGroup 适配、状态呈现、起始图标、点击聚焦、尺寸和 iOS 文本下限,且属性目标与 component:TextInput 的 FR1、FR9、FR11–FR13 一致,包括其实现差距(针对 spec:AST-102 FR4 的固定高度、无文本的错误状态、仅以颜色区分的 detached 状态以及分组描述),外加传递给 Field 的 labelIcon。 |
family:input-fields FR3、FR8–FR10;当前测试 |
| FR13 | 控制框携带 astryx-number-input,具有 data-size、data-status、data-disabled 和 data-readonly。number-input 上任意拼写的主题 padding 会同时为控制框和步进器列填充内边距。 |
architecture:component-theming-surface;当前测试 |
| FR14 | 它自身的拒绝行为遵循 entryErrorBehavior(spec:AST-117 FR1、FR2)。键入的数字仅在提交时才算完整,因此在两种值下,字段在用户键入时都不会标记或宣告任何拒绝;Enter 或失焦会揭示草稿当前的拒绝,其信号一并出现并只宣告一次,如 FR15 所述(spec:AST-117 FR3、FR4);被 FR3 钳制的数字不会显示拒绝。一旦草稿有效或为空,已显示的拒绝即被清除(spec:AST-117 FR5)。由于两种值行为相同,该字段不读取 FormLayout 默认值。 |
spec:AST-117 FR1–FR6;源代码与测试 |
| FR15 | 它自身的拒绝遵循 spec:AST-118。键入的数字仅在提交时才算完整,因此无论草稿如何,在用户键入期间它都不会标记、显示或宣告任何内容(spec:AST-118 FR1–FR3)。在 Enter 或失焦时,无法解析的草稿、仅整数模式下的分数、或当 min 大于 max 时的任何数字,都会保留其拒绝;失焦后,表单会提交已提交的值(FR6;spec:AST-118 FR4);超出普通范围的数字会被钳制并提交(FR3)。在独立使用时,除非 FR16 显示调用方提供的消息,否则拒绝会显示无效数字消息作为错误状态,同时设置 aria-invalid、将文本着色为次要颜色,并宣告一次;在 InputGroup 中,它设置 aria-invalid,警报会宣告该拒绝。当草稿有效或为空时,拒绝被清除(spec:AST-118 FR5、FR6)。 |
spec:AST-118 FR1–FR6;当前测试 |
| FR16 | 调用方的 error 状态带消息时,总是显示在字段消息的位置;不带消息的 error 状态,或 warning/success 状态,永远不会替换拒绝消息。当调用方的错误显示时,aria-invalid 保持设置,并且警报会播报一次拒绝消息,或通过回调播报调用方的(spec:AST-118 FR7)。当当前显示的拒绝发生变化时,onEntryErrorChange 会收到一个 NumberInputEntryError;当它结束时收到 null:kind 为 unreadable、fractional 或 outOfRange;text 是已键入的文本;value 是其数值,适用于 fractional 和 outOfRange。键入、Enter、失焦、新的 value、min、max 或 isIntegerOnly 以及禁用,各自都会报告变化;未变化的拒绝不会再次报告;卸载时若仍有未决拒绝则报告 null(spec:AST-118 FR8)。 |
spec:AST-118 FR7, FR8; current tests |
允许的变体¶
- AV1 — 数字格式化。
formatValue可以返回任何文本;已提交的值保持为数字。 - AV2 — 主题内边距。 主题可以更改
number-input的内边距;步进器会跟随其变化。
代表性状态¶
| 状态 | 必需不变量 | 允许的变体 |
|---|---|---|
| 静止时,已格式化 | 已格式化的文本;aria-valuetext;隐藏的原始表单值。 |
格式。 |
| 聚焦时 | 纯区域设置数字,可随时编辑。 | 区域设置。 |
| 无效草稿 | 如 FR15 所述:错误状态;aria-invalid;一次播报;保留;无 onChange。 |
— |
| 超出范围提交 | 在失焦或按 Enter 时提交钳制后的值。 | — |
| 步进器到达边界 | 该步进器 aria-disabled;步进不产生任何操作。 |
— |
| 带原因禁用 | 可聚焦;只读;不提交;无步进;原因工具提示。 | — |
转换与优先级顺序¶
- ORD1 — 键入提交。 去除首尾空格 → 空值检查 → 区域设置解析 → 整数检查 →
范围检查(仅整数时
min向上取整、max向下取整)→ 钳制 → 若已更改则提交。 - ORD2 — 步进。 当前数字(草稿有效则用草稿;已清空的草稿从空值开始步进,FR4;否则用
value)→ 下一个网格位置 → 四舍五入到步进精度与网格起始精度中更精细者 → 钳制 → 整数检查。 - ORD3 — 可用性。 先禁用,再只读,然后可编辑。
性能与资源¶
- PR1 — 单个滚轮监听器。 每个启用滚轮步进且已挂载的输入框在自身持有一个非被动滚轮监听器;仅当该输入框获得焦点时它才起作用。
无障碍契约¶
- AR1 — 旋转按钮。 FR1;公开的是已提交的值,而不是草稿。
- AR2 — 无效输入。 被拒绝的草稿会显示其消息、设置
aria-invalid,并按 FR15 所述一次性播报;失焦后仍保留,因此条目绝不会在没有消息的情况下被丢弃(WCAG 2.2 1.4.1、3.3.1)。当有调用方的error状态时,该状态会显示,且拒绝会设置aria-invalid并一次性播报(FR16)。在 InputGroup 内部,拒绝会被播报并设置aria-invalid,但没有自己的消息(spec:AST-118FR5)。 当entryErrorBehavior="blur-or-enter"时,播报会等待 Enter 或失焦(FR14)。 - AR3 — 禁用。 FR9 满足
spec:AST-085的 FR1、FR5 和 FR6。 - AR4 — 步进器。 在任意视口宽度下,紧凑的纯指针辅助控件都会在粗粒度主指针上隐藏。直接的数字输入仍然可用,并且方向键可在所有指针类型上提供键盘步进(FR4、FR5)。
- AR5 — 只读暴露。 只读的 NumberInput MUST 向辅助技术暴露其只读状态(WCAG 2.2 4.1.2)。实现缺口:旋转按钮未暴露只读状态。
设计关系¶
| 结构或状态 | 设计要求 | 呈现权威 | 层级角色 | 组件契约 |
|---|---|---|---|---|
| 输入 | 数字文本;显示拒绝时使用辅助色 (FR15)。 | 当前源代码和测试 | 主要 | FR2 |
| 单位 | 数字后的辅助文本。 | 当前源代码和测试 | 辅助 | FR7 |
| 步进器 | 在非粗粒度指针上堆叠于末端;在粗粒度主指针上隐藏,并使用常规主题的末端内边距。 | FR5;DEC-1 | 辅助 | FR5, FR13 |
design:reduced-motion 规定了清除按钮的按压缩放 (FR8);没有其他设计记录规定 NumberInput。控件框带有 number-input;使用方的结构没有命名任何控件框部件,因此该记录不包含结构主题映射。
家族与系统关系¶
family:input-fields负责分组准入、禁用原因、状态位置、焦点缩放下限、prop 目标和清除提示;NumberInput 采纳这些内容,并且不暴露isLoading或changeAction。spec:AST-085负责禁用态的可聚焦性;NumberInput 满足该要求,包括步进器。spec:AST-086的 FR3 和 FR4 负责持续存在的无效输入区域。spec:AST-117负责输入错误行为;FR14 映射其 FR1–FR6。spec:AST-118负责拒绝输入反馈;FR15 和 FR16 映射其 FR1–FR8 以及 NumberInput 的完成点。architecture:internationalization负责解析器使用的区域设置解析。component:TextInput是 FR12 所指的共享文本字段行为的参考。
验证映射¶
| 契约 | 验证 | 代表性状态 | 变更或失败预期 | 审计章节 |
|---|---|---|---|---|
| FR1, AR1 | NumberInput.test.tsx spinbutton 属性套件;NumberInput.a11y.chromium.spec.ts |
有界、无界、已格式化 | 缺少 role 或 ARIA 值即失败。 | audit:NumberInput/accessibility |
| FR2, AR2 | numberParser.test.ts;numberParser.docblock.test.ts;NumberInput.test.tsx 无效反馈套件 |
区域设置、分组、无效文本 | 错误解析、提交猜测值或缺少公告即失败。 | audit:NumberInput/behavior |
| FR3, ORD1 | numberInputCommit.test.ts;NumberInput.test.tsx 验证、提交策略、钳制、键盘清除套件 |
失焦、回车、空值、钳制、反向范围 | 每次按键触发 onChange、未钳制的提交或错误的清除即失败。 |
audit:NumberInput/behavior |
| FR4, FR5, ORD2, AR4, PR1 | NumberInput.test.tsx 步进和步进器套件;滚轮监听用例 |
按键、滚轮、步进器;边界;空值;精度 | 偏离步进网格、越过边界或带修饰键的步进即失败。证据缺口:没有测试覆盖从已清空的草稿步进到某个值的情况。 | audit:NumberInput/behavior |
| FR6, FR7 | NumberInput.test.tsx 格式化显示、表单和单位套件;NumberInput.rejectedEntry.test.tsx "form value" 套件 |
静态和聚焦;表单提交;失焦后保留的草稿 | 提交格式化值、失焦后保留的草稿发布了其文本,或未描述单位,即失败。 | audit:NumberInput/behavior |
| FR8 | NumberInput.test.tsx hasClear 套件 |
清除;禁用;只读 | 在禁用字段上清除,或未产生 null,即失败。证据缺口:没有测试在减少动态效果模式下按下清除按钮。 |
audit:NumberInput/behavior |
| FR9, FR10, ORD3, AR3 | NumberInput.test.tsx 的 disabled、disabledMessage、只读和 form 套件;InputGroup.test.tsx 的 disabled 传播用例 |
禁用、原因、只读 | 丢失 Tab 焦点停靠点、提交被禁用的值,或在只读时步进,即失败。 | audit:NumberInput/accessibility |
| FR12 | NumberInput.fr10.test.tsx;NumberInput.test.tsx 状态和点击聚焦套件 |
独立和分组 | 基础 prop 不在输入上,或样式作用在错误的部件上,即失败。 | audit:NumberInput/api |
| FR13 | NumberInput.test.tsx 主题状态和步进器内边距测试套件 |
每种内边距写法 | 忽略主题内边距的步进器会失败。 | audit:NumberInput/theming |
| AR5 | NumberInput.a11y.chromium.spec.ts 及其记录的已知失败 |
只读 | 当差距消除后,该已知失败不再匹配。 | audit:NumberInput/accessibility |
| FR11 | NumberInput.test.tsx “不会在组合键按下(IME)时步进或提交”和“等待 IME 组合完成后再提交” |
组合状态下的方向键和 Enter | 在组合期间步进或提交会失败。 | audit:NumberInput/behavior |
| FR5, FR13, AR4 | NumberInput.coarse-pointer.a11y.chromium.spec.ts |
在 390 和 1280 px 下的粗/非粗指针,LTR/RTL,非默认主题末尾内边距 | 可见的粗指针步进器、隐藏的细指针步进器、错误的末尾内边距或丢失的直接/键盘输入均会导致失败。 | audit:NumberInput/behavior |
| FR5 | NumberInput.test.tsx “按住步进器”套件 |
按住并释放;指针取消;边界;点击;手指按压 | 每次重复提交一次、释放后继续重复,或在字段变为禁用或只读后步进,都会失败。 | audit:NumberInput/behavior |
| FR14, AR2 | NumberInput.rejectedEntry.test.tsx “NumberInput entryErrorBehavior”用例;Pagination.test.tsx 的 FormLayout 用例 |
-;1a;10–100 中的 150;每个值;Enter 和失焦 |
在 'blur-or-enter' 下提交前发出信号、孤立信号、未宣告的回退,或在 'complete' 下发生更改,均失败。 |
audit:NumberInput/behavior |
| FR15, AR2 | NumberInput.rejectedEntry.test.tsx “NumberInput 被拒绝输入”套件;numberInputCommit.test.ts 的拒绝用例 |
-;1a;仅整数 1.5;max={100} 时的 150;反向范围;键入;提交 |
键入时出现标记或警告、提交时遗漏拒绝、草稿丢失,或孤立信号,均失败。 | audit:NumberInput/behavior |
| FR16 | NumberInput.rejectedEntry.test.tsx “onEntryErrorChange”和“被拒绝输入与调用方状态”套件 |
每种类型;无状态、error、warning、success 状态;有或无回调;卸载 |
缺失或重复的报告、错误的 kind 或 value,或覆盖调用方状态的错误消息,均失败。 |
audit:NumberInput/behavior |
当前状态影响¶
- 只读状态未暴露(AR5)。 只读 NumberInput 的 spinbutton 不暴露只读状态,因此辅助技术用户可能认为可以编辑它。无障碍测试套件将此项记录为已知失败。
- 减少动态效果下的清除按压(FR8)。 当用户偏好减少动态效果时,清除按钮在按下时缩放至 0.98,正如
component:ButtonFR15 所记录,这与design:reduced-motionDR1 相悖。 - 继承自 TextInput 的缺口(FR12)。 固定高度(
spec:AST-102FR4)、仅通过颜色和图标显示且没有消息的错误状态(WCAG 2.2 3.3.1)、仅通过颜色显示且没有消息的detached状态(WCAG 2.2 1.4.1),以及component:TextInput记录的分组描述引用,均在此适用。 - 步进器图标键。 步进器通过
numberInput:stepperDown扩展键而非组件插槽模型解析其图标,这正是已知偏差architecture:icon-resolution-and-component-slots所指;它在该记录的退出条件下退出。
决策日志¶
NumberInput 适用 family:input-fields 和 spec:AST-085。
DEC-1 — 紧凑步进器遵循主指针精度¶
参考: component:NumberInput/DEC-1
决策者: imdreamrunner,2026-10-29
粗主指针的呈现使用直接数字输入而非紧凑步进器,与视口宽度无关,且不提供退出选项。非粗指针步进器和键盘步进保留其合约。紧凑按钮是呈现辅助:数值、验证、回调、直接输入和键盘步进合约不依赖于它们的可见性。适配这些辅助不需要调用方进行源代码或配置迁移。
已拒绝:基于宽度的激活,因为决定该控件可用性的是指针精度,而非可用布局宽度。
未决问题¶
无。
内容边界¶
本文件不重复使用方的 prop 表格/示例、当前审计结果、实施步骤或家族/系统规则,而是链接到对应内容的负责人。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 as/astryx