职责与结构
数字输入用于需要精确填写的数量、预算或百分比。快速调整使用滑杆；账号、电话、编号等不能运算的值使用文本输入，不能因只含数字就使用 number。
明确标签和单位 + 原生 number 输入 + 边界或步长说明 + 字段错误。百分比后缀仅补充单位，范围与单位仍写入标签和帮助。
变体与 Tokens
| 项目 | 规范 |
|---|---|
| 整数／小数 | min、max、step 由业务给定；数量示例为 0–200、步长 1，比例为 0–100%、步长 5。金额可设置 step="0.01"，精度规则由表单校验。 |
| 空／必填／错误 | 空值和 0 分别处理；required 用于必填。越界、非法数值与步长不匹配显示具体字段错误，保留用户输入。 |
| 只读／禁用 | readonly 允许聚焦、复制并参与表单提交；disabled 不可编辑且不参与提交。说明不可修改原因。 |
| 状态复用 | 默认、悬停、焦点、已填写与错误继承 .control；提交处理中由表单禁用提交按钮并反馈，不把每个输入改成加载按钮。 |
复用 .control 的 --control-md、--radius-sm、--field-surface、共享字号、焦点与错误色；字段间距使用 --field-gap / --field-group-gap。
交互与状态示例
交互与无障碍
Tab 聚焦，键盘输入及平台原生步进保持可用；不拦截粘贴和输入法。不在每次输入时强制夹紧或恢复旧值。input / change 校验边界与步长，错误用 aria-invalid 与 aria-describedby 关联；提交聚焦首个错误，修正后清除。窄屏字段换行，单位不遮挡输入。
接入约定
| 项目 | 规范 |
|---|---|
| value / min / max / step / required | 使用原生 input type="number" 属性与 validity；空值不能通过 Number("") 当作 0。本页数值范围仅为演示。 |
| readonly / disabled | readonly 保留读取与提交能力；disabled 只用于不参与当前操作的字段。 |
| 事件与校验 | 原生 input / change / reset；本页 data-family-number 复用 .control 和 validity，成功只确认本页值，不执行请求或持久化。 |
查看最小使用示例
<label for="quantity">处理批次数</label>
<input class="control" id="quantity" type="number" min="0" max="200" step="1" required>
// 用 validity 判断边界和步长；空值与 0 区分。维护位置：scripts/family-specimens.mjs；示例行为：scripts/family-specimens.js。组合应用见本页末尾引用。