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 表格僅在瀏覽器中載入