大网数据广告活动
Web 标准与前端开发

HTML 属性:max

· 52CE 我爱测

**`max`** 属性定义了输入字段所能接受的最大值。如果元素的 `value` 大于此值,则该元素将不能通过校验。此值必须大于等于 `min` 属性的值。如果存在 `max` 属性但未指定或无效,则 `max` 值不会被应用。如果 `max` 属性有效,并且非空值大于 `max` 属性所允许的最大值,则约束验证将阻止表单提交。

max 属性定义了输入字段所能接受的最大值。如果元素的 value 大于此值,则该元素将不能通过校验。此值必须大于等于 min 属性的值。如果存在 max 属性但未指定或无效,则 max 值不会被应用。如果 max 属性有效,并且非空值大于 max 属性所允许的最大值,则约束验证将阻止表单提交。

max 属性适用于数值类型的输入,包括 input/date、input/month、input/week、input/time、input/datetime-local、input/number 和 input/range 类型,以及 progress 和 meter 元素。它是一个数值,用于指定表单控件被认为有效的最大正值。

如果值超出了允许的最大值,validityState.rangeOverflow 将为 true,且控件会匹配 :out-of-range 和 :invalid 伪类。

语法

<table class="no-markdown"> <caption> 各输入类型的 <code>max</code> 值语法 </caption> <thead> <tr> <th>输入类型</th> <th>语法</th> <th>示例</th> </tr> </thead> <tbody> <tr> <td>input/date</td> <td><code>yyyy-mm-dd</code></td> <td><code><input type="date" max="2019-12-25" step="1"></code></td> </tr> <tr> <td>input/month</td> <td><code>yyyy-mm</code></td> <td><code><input type="month" max="2019-12" step="12"></code></td> </tr> <tr> <td>input/week</td> <td><code>yyyy-W##</code></td> <td><code><input type="week" max="2019-W23" step=""></code></td> </tr> <tr> <td>input/time</td> <td><code>HH:mm</code></td> <td><code><input type="time" max="17:00" step="900"></code></td> </tr> <tr> <td> input/datetime-local </td> <td><code>yyyy-mm-ddTHH:mm</code></td> <td> <code><input type="datetime-local" max="2019-12-25T23:59"></code> </td> </tr> <tr> <td>input/number</td> <td><a href="/zh-CN/docs/Web/CSS/Reference/Values/number"><number></a></td> <td> <code><input type="number" min="0" step="5" max="100"></code> </td> </tr> <tr> <td>input/range</td> <td><a href="/zh-CN/docs/Web/CSS/Reference/Values/number"><number></a></td> <td> <code><input type="range" min="60" step="5" max="100"></code> </td> </tr> </tbody> </table>

[!NOTE] 当用户输入的数据不符合设置的最大值时,该值在约束验证中被视为无效,并会匹配 :invalid 和 :out-of-range 伪类。

请参阅客户端验证和 ValidityState.rangeOverflow 了解更多信息。

对于 progress 元素,max 属性描述了 progress 元素所表示的任务一共需要完成多少工作。如果该属性存在,必须具有大于零的值,并且是有效的浮点数。对于 meter 元素,max 属性定义了测量范围的上限值。此值必须大于最小值(如果指定了min 属性)。在这两种情况下,如果省略,默认值为 1。

<table class="no-markdown"> <caption> 其他元素的 <code>max</code> 值语法 </caption> <thead> <tr> <th>元素类型</th> <th>语法</th> <th>示例</th> </tr> </thead> <tbody> <tr> <td>progress</td> <td><a href="/zh-CN/docs/Web/CSS/Reference/Values/number"><number></a></td> <td> <code ><progress id="file" max="100" value="70"> 70% </progress></code > </td> </tr> <tr> <td>meter</td> <td><a href="/zh-CN/docs/Web/CSS/Reference/Values/number"><number></a></td> <td> <code ><meter id="fuel" min="0" max="100" low="33" high="66" optimum="80" value="40"> at 40/100</meter></code > </td> </tr> </tbody> </table>

无障碍考虑

提供帮助用户了解如何填写表单并使用各个表单控件的指引。标明任何必填和可选的输入项、数据格式以及其他相关信息。在使用 max 属性时,确保用户理解最大值的要求。可以通过 label 提供说明。如果需要在标签之外提供上述说明以实现更灵活的布局设计,请考虑使用 aria-labelledby 或 aria-describedby。

规范

浏览器兼容性

参见

  • step
  • min
  • 其他 meter 属性:low、high、optimum
  • 约束验证
  • 表单校验
  • validityState.rangeOverflow
  • :out-of-range
  • input
  • input/date、input/month、input/week、input/time、input/datetime-local、input/number 和 input/range 类型,以及 meter

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。