HTML 屬性:max

max 屬性定義了包含該屬性的輸入所能接受和有效的最大值。如果元素的 value 大於此值,則該元素將 驗證 失敗。此值必須大於或等於 min 屬性的值。如果存在 max 屬性但未指定或無效,則不會應用 max 值。如果 max 屬性有效且一個非空值大於 max 屬性允許的最大值,則約束驗證將阻止表單提交。

max 屬性對數字輸入型別有效,包括 datemonthweektimedatetime-localnumberrange 型別,以及 <progress><meter> 元素。它是一個數字,指定表單控制元件在被視為有效之前可能擁有的最大正值。

如果值超過允許的最大值,則 validityState.rangeOverflow 將為 true,並且該控制元件將匹配 :out-of-range:invalid 偽類。

語法

按輸入 type 指定 max 值的語法
輸入型別 語法 示例
日期 yyyy-mm-dd <input type="date" max="2019-12-25" step="1">
月份 yyyy-mm <input type="month" max="2019-12" step="12">
yyyy-W## <input type="week" max="2019-W23" step="">
時間 HH:mm <input type="time" max="17:00" step="900">
datetime-local yyyy-mm-ddTHH:mm <input type="datetime-local" max="2019-12-25T23:59">
數字 <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 偽類。

有關更多資訊,請參閱 客戶端驗證rangeOverflow

對於 <progress> 元素,max 屬性描述了 progress 元素指示的任務所需的工作量。如果存在,必須大於零,並且是一個有效的浮點數。對於 <meter> 元素,max 屬性定義了測量範圍的上限數值。如果指定了(min 屬性),則必須大於最小值。在這兩種情況下,如果省略,則預設值為 1。

其他元素的 max 值語法
輸入型別 語法 示例
<progress> <number> <progress id="file" max="100" value="70"> 70% </progress>
<meter> <number> <meter id="fuel" min="0" max="100" low="33" high="66" optimum="80" value="40"> at 40/100</meter>

可訪問性考慮

提供說明以幫助使用者瞭解如何完成表單以及使用各個表單控制元件。指明任何必需和可選的輸入、資料格式以及其他相關資訊。使用 max 屬性時,請確保使用者理解此最大要求。在 <label> 中提供說明可能就足夠了。如果不在標籤內提供說明,允許更靈活的定位和設計,可以考慮使用 aria-labelledbyaria-describedby

規範

規範
HTML
# attr-input-max
HTML
# attr-meter-max
HTML
# attr-progress-max

瀏覽器相容性

html.elements.input.max

html.elements.meter.max

html.elements.progress.max

另見