在此页

• 可访问性关注
• 规范
• 另请参阅
• 相关话题

草案
此页面不完整。

step attribute is a number that specifies the granularity that the value must adhere to or the keyword any . It is valid for the numeric input types, including the date , month , week , time , datetime-local , number and range 类型。

step 设置 stepping interval when clicking up and down spinner buttons, moving a slider left and right on a range, and validating the different date types. If not explicitly included, step defaults to 1 for 编号 and range , and 1 unit type (minute, week, month, day) for the date/time input types. The value can must be a positive number - integer or float -- or the special value any , which means no stepping is implied, and any value is allowed (barring other constraints, such as min and max ).

The default stepping value for 编号 inputs is 1, allowing only integers to be entered, unless the stepping base is not an integer. The default stepping value for time is 1 second, with 900 being equal to 15 minutes.

Default values for step

Input type	值	范例
date	1 (day)	<input type="date" min="2019-12-25" step="1">
month	1 (month)	<input type="month" min="2019-12" step="12">
week	1 (week)	<input type="week" min="2019-W23" step="2">
time	60 (seconds)	<input type="time" min="09:00" step="900">
datetime-local	1 (day)	<input type="datetime-local" min="019-12-25T19:30" step="7">
number	1	<input type="number" min="0" step="0.1" max="10">
range	1	<input type="range" min="0" step="2" max="10">

若 any is not explicity set, valid values for the 编号 , date/time input types, and range input types are equal to the basis for stepping - the min value and increments of the step value, up to the max value, if specified. For example, if we have <input type="number" min="10" step="2"> any even integer, 10 or great, is valid. If omitted, <input type="number"> , any integer is valid, but floats, like 4.2, are not valid, as step defaults to 1. For 4.2 to be valid, step would have had to be set to any , 0.1, 0.2, or any the min value would have had to be a number ending in .2, such as <input type="number" min="-5.2">

min impact on step

值 min and step define what are valid values, even if the step attribute is not included, as step 默认为 0 .

We add a big red border around invalid inputs:

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

Then define an input with a minimum value of 7.2, omitting the step attribute, wherein it defaults to 1.

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

Valid values include 1.2 , 3.2 , 5.2 , 7.2 , 9.2 , 11.2 , and so on. Integers and even numbers follwed by .2 are not valid. As we included an invalid value, supporting browsers will show the value as invalid. The number spinner, if present, will only show valid float values of 1.2 and greater

注意： When the data entered by the user doesn't adhere to the stepping configuration, the value is considered invalid in constraint validation and will match the :invalid and :out-of-range pseudoclasses

见 Client-side validation and stepMismatch 了解更多信息。

可访问性关注

Provide instructions to help users understand how to complete the form and use individual form controls. Indicate any required and optional input, data formats, and other relevant information. When using the min attribute, ensure this minimum requirement is understood by the user. Providing instructions within the <label> may be sufficient. If providing instructions outside of labels, which allows more flexible positioning and design, consider using aria-labelledby or aria-describedby .

规范

规范	状态	注释
HTML 实时标准 The definition of 'step attribute' in that specification.	实时标准
HTML5 The definition of 'step attribute' in that specification.	推荐

另请参阅

• min
• constraint validation
• Constraint validation.1 API
• validityState.stepMismatch
• :out-of-range
• <input>

元数据

• 最后修改： Sep 28, 2020

相关话题

1. HTML
2. 教程：
3. HTML 基础
4. HTML 介绍

   1. Introduction to HTML overview
   2. Getting started with HTML
   3. What's in the head? Metadata in HTML
   4. HTML text fundamentals
   5. Creating hyperlinks
   6. Advanced text formatting
   7. Document and website structure
   8. Debugging HTML
   9. Assessment: Marking up a letter
   10. Assessment: Structuring a page of content
5. 多媒体和嵌入

   1. Multimedia and embedding overview
   2. Images in HTML
   3. Video and audio content
   4. From object to iframe — other embedding technologies
   5. Adding vector graphics to the Web
   6. Responsive images
   7. Assessment: Mozilla splash page
6. 参考：
7. HTML 元素

   1. <a>
   2. <abbr>
   3. <acronym>
   4. <address>
   5. <applet>
   6. <area>
   7. <article>
   8. <aside>
   9. <audio>
   10. <b>
   11. <base>
   12. <basefont>
   13. <bdi>
   14. <bdo>
   15. <bgsound>
   16. <big>
   17. <blink>
   18. <blockquote>
   19. <body>
   20. <br>
   21. <button>
   22. <canvas>
   23. <caption>
   24. <center>
   25. <cite>
   26. <code>
   27. <col>
   28. <colgroup>
   29. <command>
   30. <content>
   31. <data>
   32. <datalist>
   33. <dd>
   34. <del>
   35. <details>
   36. <dfn>
   37. <dialog>
   38. <dir>
   39. <div>
   40. <dl>
   41. <dt>
   42. <element>
   43. <em>
   44. <embed>
   45. <fieldset>
   46. <figcaption>
   47. <figure>
   48. <font>
   49. <footer>
   50. <form>
   51. <frame>
   52. <frameset>
   53. <h1>
   54. <head>
   55. <header>
   56. <hgroup>
   57. <hr>
   58. <html>
   59. <i>
   60. <iframe>
   61. <image>
   62. <img>
   63. <input>
   64. <ins>
   65. <isindex>
   66. <kbd>
   67. <keygen>
   68. <label>
   69. <legend>
   70. <li>
   71. <link>
   72. <listing>
   73. <main>
   74. <map>
   75. <mark>
   76. <marquee>
   77. <menu>
   78. <menuitem>
   79. <meta>
   80. <meter>
   81. <multicol>
   82. <nav>
   83. <nextid>
   84. <nobr>
   85. <noembed>
   86. <noframes>
   87. <noscript>
   88. <object>
   89. <ol>
   90. <optgroup>
   91. <option>
   92. <output>
   93. <p>
   94. <param>
   95. <picture>
   96. <plaintext>
   97. <pre>
   98. <progress>
   99. <q>
   100. <rb>
   101. <rp>
   102. <rt>
   103. <rtc>
   104. <ruby>
   105. <s>
   106. <samp>
   107. <script>
   108. <section>
   109. <select>
   110. <shadow>
   111. <slot>
   112. <small>
   113. <source>
   114. <spacer>
   115. <span>
   116. <strike>
   117. <strong>
   118. <style>
   119. <sub>
   120. <summary>
   121. <sup>
   122. <table>
   123. <tbody>
   124. <td>
   125. <template>
   126. <textarea>
   127. <tfoot>
   128. <th>
   129. <thead>
   130. <time>
   131. <title>
   132. <tr>
   133. <track>
   134. <tt>
   135. <u>
   136. <ul>
   137. <var>
   138. <video>
   139. <wbr>
   140. <xmp>
8. 全局属性

   1. accesskey
   2. autocapitalize
   3. class
   4. contenteditable
   5. contextmenu
   6. data-*
   7. dir
   8. draggable
   9. dropzone
   10. hidden
   11. id
   12. inputmode
   13. is
   14. itemid
   15. itemprop
   16. itemref
   17. itemscope
   18. itemtype
   19. lang
   20. part
   21. slot
   22. spellcheck
   23. style
   24. tabindex
   25. title
   26. translate
   27. x-ms-acceleratorkey
   28. x-ms-format-detection
9. <input> 类型

   1. <input type="button">
   2. <input type="checkbox">
   3. <input type="color">
   4. <input type="date">
   5. <input type="datetime">
   6. <input type="datetime-local">
   7. <input type="email">
   8. <input type="file">
   9. <input type="hidden">
   10. <input type="image">
   11. <input type="month">
   12. <input type="number">
   13. <input type="password">
   14. <input type="radio">
   15. <input type="range">
   16. <input type="reset">
   17. <input type="search">
   18. <input type="submit">
   19. <input type="tel">
   20. <input type="text">
   21. <input type="time">
   22. <input type="url">
   23. <input type="week">
10. 文档编制：
11. 有用清单

    All pages index

    Pages tagged "HTML"
12. 贡献

    1. HTML 文档状态
    2. MDN 工程