HTML 属性: min
min
属性定义包含该属性的输入的最小可接受值和有效值。如果元素的 value
小于此值,则元素将无法通过 验证。此值必须小于或等于 max
属性的值。
某些输入类型具有默认最小值。如果输入没有默认最小值,并且为 min
指定的值无法转换为有效数字(或者没有设置最小值),则输入没有最小值。
它对于包括以下输入类型的输入有效:date、month、week、time、datetime-local、number 和 range 类型,以及 <meter>
元素。
语法
输入类型 | 语法 | 示例 |
---|---|---|
date | yyyy-mm-dd |
<input type="date" min="2019-12-25" step="1"> |
month | yyyy-mm |
<input type="month" min="2019-12" step="12"> |
week | yyyy-W## |
<input type="week" min="2019-W23" step=""> |
time | hh:mm |
<input type="time" min="09:00" step="900"> |
datetime-local | yyyy-mm-ddThh:mm |
<input type="datetime-local" min="2019-12-25T19:30"> |
number | <number> | <input type="number" min="0" step="5" max="100"> |
range | <number> | <input type="range" min="60" step="5" max="100"> |
注意:当用户输入的数据不符合设定的最小值时,该值在约束验证中被视为无效,并将匹配 :invalid
和 :out-of-range
伪类。
有关更多信息,请参见 客户端验证 和 rangeUnderflow
。
对于 <meter>
元素,min
属性定义测量范围的下限。它必须小于最大值(如果指定了 max
属性)。在这两种情况下,如果省略,该值默认为 1。
对步长的影响
min
和 step
的值定义了哪些值是有效的,即使 step
属性未包含,因为 step
默认为 0
。
我们在无效输入周围添加一个大的红色边框
input:invalid {
border: solid red 3px;
}
然后定义一个最小值为 7.2 的输入,省略 step 属性,其中它默认为 1。
<input id="myNumber" name="myNumber" type="number" min="7.2" value="8" />
由于 step
默认为 1,因此有效值包括 7.2
、8.2
、9.2
等。值 8 无效。由于我们包含了一个无效值,因此支持的浏览器会将该值显示为无效。
如果未显式包含,step
对于 number
和 range
默认为 1,对于日期/时间输入类型,则为 1 个时间单位(秒、周、月、天)。
无障碍性问题
提供说明以帮助用户了解如何完成表格并使用各个表单控件。指出任何必填和可选输入、数据格式以及其他相关信息。使用 min
属性时,请确保用户了解此最低要求。在 <label>
中提供说明可能就足够了。如果在标签之外提供说明,这将允许更灵活的定位和设计,请考虑使用 aria-labelledby
或 aria-describedby
。
规范
规范 |
---|
HTML 标准 # attr-input-min |
HTML 标准 # attr-meter-max |
浏览器兼容性
html.elements.input.min
BCD 表格仅在浏览器中加载
html.elements.meter.min
BCD 表格仅在浏览器中加载