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

另請參見