HTML 属性: min

min 属性定义包含该属性的输入的最小可接受值和有效值。如果元素的 value 小于此值,则元素将无法通过 验证。此值必须小于或等于 max 属性的值。

某些输入类型具有默认最小值。如果输入没有默认最小值,并且为 min 指定的值无法转换为有效数字(或者没有设置最小值),则输入没有最小值。

它对于包括以下输入类型的输入有效:datemonthweektimedatetime-localnumberrange 类型,以及 <meter> 元素。

语法

按输入 type 划分 min 值的语法
输入类型 语法 示例
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 值语法
输入类型 语法 示例
<meter> <number> <meter id="fuel" min="0" max="100" low="33" high="66" optimum="80" value="40"> at 40/100</meter>

对步长的影响

minstep 的值定义了哪些值是有效的,即使 step 属性未包含,因为 step 默认为 0

我们在无效输入周围添加一个大的红色边框

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

然后定义一个最小值为 7.2 的输入,省略 step 属性,其中它默认为 1。

html
<input id="myNumber" name="myNumber" type="number" min="7.2" value="8" />

由于 step 默认为 1,因此有效值包括 7.28.29.2 等。值 8 无效。由于我们包含了一个无效值,因此支持的浏览器会将该值显示为无效。

如果未显式包含,step 对于 numberrange 默认为 1,对于日期/时间输入类型,则为 1 个时间单位(秒、周、月、天)。

无障碍性问题

提供说明以帮助用户了解如何完成表格并使用各个表单控件。指出任何必填和可选输入、数据格式以及其他相关信息。使用 min 属性时,请确保用户了解此最低要求。在 <label> 中提供说明可能就足够了。如果在标签之外提供说明,这将允许更灵活的定位和设计,请考虑使用 aria-labelledbyaria-describedby

规范

规范
HTML 标准
# attr-input-min
HTML 标准
# attr-meter-max

浏览器兼容性

html.elements.input.min

BCD 表格仅在浏览器中加载

html.elements.meter.min

BCD 表格仅在浏览器中加载

另请参见