HTML 屬性:max
max 屬性定義了包含該屬性的輸入可接受和有效的最大值。如果元素的value大於此值,則元素將無法透過驗證。此值必須大於或等於min 屬性的值。如果 max 屬性存在但未指定或無效,則不應用任何 max 值。如果 max 屬性有效且非空值大於 max 屬性允許的最大值,則約束驗證將阻止表單提交。
對數字輸入型別有效,包括日期、月份、星期、時間、日期時間本地、數字 和 範圍 型別,以及<progress> 和<meter> 元素,max 屬性是一個數字,它指定表單控制元件要被視為有效的最正值。
如果值超過允許的最大值,則validityState.rangeOverflow 將為 true,並且控制元件將與:out-of-range 和:invalid 偽類匹配。
語法
| 輸入型別 | 語法 | 示例 |
|---|---|---|
| 日期 | 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"> |
| 本地日期時間 | yyyy-mm-ddThh:mm |
<input type="datetime-local" max="2019-12-25T23:59"> |
| 數字 | <number> | <input type="number" min="0" step="5" max="100"> |
| 範圍 | <number> | <input type="range" min="60" step="5" max="100"> |
注意:當用戶輸入的資料不符合設定的最大值時,該值在約束驗證中被視為無效,並將匹配:invalid和:out-of-range偽類。
有關更多資訊,請參閱客戶端驗證和rangeOverflow。
對於<progress>元素,max屬性描述了progress元素指示的任務需要完成多少工作。如果存在,則必須大於零且為有效的浮點數。對於<meter>元素,max屬性定義了測量範圍的上限。如果指定了最小值(min屬性),則此值必須大於最小值。在這兩種情況下,如果省略,則預設值為 1。
| 輸入型別 | 語法 | 示例 |
|---|---|---|
<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-labelledby或aria-describedby。
規範
| 規範 |
|---|
| HTML 標準 # attr-input-max |
| HTML 標準 # attr-meter-max |
| HTML 標準 # attr-progress-max |
瀏覽器相容性
html.elements.input.max
BCD 表格僅在瀏覽器中載入
html.elements.meter.max
BCD 表格僅在瀏覽器中載入
html.elements.progress.max
BCD 表格僅在瀏覽器中載入