大网数据广告活动
Web 标准与前端开发

HTML 属性:step

· 52CE 我爱测

**`step`** 属性是值必须遵循的粒度数值,或关键字 `any`。此属性对数值输入类型有效,包括 input/date、input/month、input/week、input/time、input/datetime-local、input/number 和 input/range 类型。

step 属性是值必须遵循的粒度数值,或关键字 any。此属性对数值输入类型有效,包括 input/date、input/month、input/week、input/time、input/datetime-local、input/number 和 input/range 类型。

step 设置了点击上下旋转按钮、在范围上左右移动滑块以及验证不同日期类型时的步进间隔。如果没有明确指定,number 和 range 的 step 默认为 1,日期/时间输入类型的 step 默认为 1 个单位类型(分、周、月、日)。值必须是正数(整数或浮点数)或特殊值 any,这意味着不隐含步进,允许任何值(除其他限制外,如 min 和 max)。

number 输入类型的默认步进值为 1,只允许输入整数,除非步进基数不是整数。time 的默认步进值为 60 秒,值 900 等同于 15 分钟。

语法

<table class="no-markdown"> <caption> step 的默认值 </caption> <thead> <tr> <th>输入类型</th> <th>值</th> <th>示例</th> </tr> </thead> <tbody> <tr> <td>input/date</td> <td>1(天)</td> <td><code><input type="date" min="2019-12-25" step="1"></code></td> </tr> <tr> <td>input/month</td> <td>1(个月)</td> <td><code><input type="month" min="2019-12" step="12"></code></td> </tr> <tr> <td>input/week</td> <td>1(周)</td> <td><code><input type="week" min="2019-W23" step="2"></code></td> </tr> <tr> <td>input/time</td> <td>60(秒)</td> <td><code><input type="time" min="09:00" step="900"></code></td> </tr> <tr> <td> input/datetime-local </td> <td>60(秒)</td> <td> <code ><input type="datetime-local" min="2019-12-25T19:30" step="900"></code > </td> </tr> <tr> <td>input/number</td> <td>1</td> <td> <code><input type="number" min="0" step="0.1" max="10"></code> </td> </tr> <tr> <td>input/range</td> <td>1</td> <td><code><input type="range" min="0" step="2" max="10"></code></td> </tr> </tbody> </table>

如果未明确设置 any,则 number、日期/时间输入类型和 range 输入类型的有效值等于步进的基础值(min 值)和步进值的增量,如果指定了 max 值,则增量最大为 max。以下示例的结果是对任何 10 或更大的偶整数都有效:

<input type="number" min="10" step="2" />

如果省略了 step 值,任何整数均有效,但对像 4.2 这样的浮点数无效,因为 step 默认为 1。要使得 4.2 成为有效值:

  • 将 step 设置为 any、0.1 或 0.2
  • min 值以 .2 结束,如 0.2、1.2 或 -5.2

示例

step 中 min 的影响

即使不包含 step 属性,min 的值也能定义有效值。这是因为对于 number 输入类型,step 的默认值是 1。

在本例中,我们会在无效输入的周围添加一个大红边框:

input:invalid {
  border: solid red 3px;
}

然后,我们定义一个最小值为 1.2、步长值为 2 的输入:

<input id="myNumber" name="myNumber" type="number" step="2" min="1.2" />

有效值包括 1.2、3.2、5.2、7.2、9.2、11.2 等。只有整数部分为奇数、小数部分为 0.2 的浮点数才有效。数字旋转器(如果存在)会生成 1.2 或更大的有效浮点数值,增量为 2。

step 中 min 的影响

[!NOTE] 当用户输入的数据不符合步进配置时,该值在约束验证中被视为无效,并将匹配 :invalid 和 :out-of-range 伪类。

参见客户端验证和 ValidityState.stepMismatch 以了解更多信息。

无障碍考虑

提供说明,帮助用户了解如何填写表单和使用各个表单控件。说明任何必需和可选的输入、数据格式以及其他相关信息。使用 min 属性时,应确保用户理解这一最低要求。在 label 中提供说明可能就足够了。如果在标签之外提供说明,这样可以更灵活地定位和设计,可以考虑使用 aria-labelledby 或 aria-describedby。

规范

浏览器兼容性

参见

  • max
  • min
  • 约束验证
  • 表单验证
  • validityState.stepMismatch
  • :out-of-range
  • input
  • input/date、input/month、input/week、input/time、input/datetime-local、input/number 和 input/range 输入类型,meter 元素

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。