<meter> HTML 元素表示在已知范围内的标量值或分数值。
HTML Demo: <meter>
<label for="fuel">Fuel level:</label>
<meter id="fuel" min="0" max="100" low="33" high="66" optimum="80" value="50">
at 50/100
</meter>
label {
padding-right: 10px;
font-size: 1rem;
}
属性
此元素包含全局属性。
-
value-
: 当前数值。如果指定了最小值和最大值(
min属性和max属性),则必须介于这两个值之间。如果未指定或格式错误,则值为0。如果指定的值不在min属性和max属性给定的范围内,则该值等于范围的最近端。[!NOTE] 除非
value属性介于0和1之间(包括 0 和 1),否则min和max属性应定义范围,以便value属性的值在该范围内。
-
-
- : 测量范围的下限。如果指定,该值必须小于最大值(
max属性)。如果未指定,则最小值为0。
- : 测量范围的下限。如果指定,该值必须小于最大值(
-
- : 测量范围的上限。如果指定,该值必须大于最小值(
min属性)。如果未指定,则最大值为1。
- : 测量范围的上限。如果指定,该值必须大于最小值(
-
low- : 测量范围低档部分的数值上限。该值必须大于最小值(
min属性),如果指定了高档值和最大值(分别为high属性和max属性),也必须小于高档值和最大值。如果未指定或小于最小值,low值等于最小值。
- : 测量范围低档部分的数值上限。该值必须大于最小值(
-
high- : 测量范围高档部分的数值下限。该值必须小于最大值(
max属性),且必须大于低档值(low属性)和最小值(min属性),如果未指定或大于最大值,则high值等于最大值。
- : 测量范围高档部分的数值下限。该值必须小于最大值(
-
optimum- : 该属性表示最佳数值。必须在
min属性和max属性定义的范围内。当与low属性和high属性一起使用时,它表示范围内哪个位置更合适。例如,如果值介于min属性和low属性之间,则认为首选低档范围的。浏览器可能会根据值是否小于或等于最佳值来为仪表条附着不同的颜色。
- : 该属性表示最佳数值。必须在
-
form- : 此可选属性用于显式设置
<meter>元素的 form 所有者。如果省略,则<meter>元素将与其<form>父元素关联,或者与另一个父元素(例如 fieldset)上的form属性所设置的表单相关联(如果有的话)。如果包含,则该值必须是同一文档树中的<form>元素的id。
- : 此可选属性用于显式设置
示例
简单示例
HTML
<p>电池电量:<meter min="0" max="100" value="75">75%</meter></p>
结果
简单示例
高档和低档范围示例
请注意,在此示例中省略了 min 属性。这是允许的,因为它的默认值为 0。
HTML
<p>
学生的考试成绩:<meter min="0" low="50" high="80" max="100" value="84">
84%
</meter>
</p>
结果
高档和低档范围示例
技术概要
<table class="properties"> <tbody> <tr> <th scope="row"> <a href="/zh-CN/docs/Web/HTML/Guides/Content_categories" >内容分类</a > </th> <td> <a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#流式内容" >流式内容</a >、<a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#短语内容" >短语内容</a >、可标记内容、可感知内容。 </td> </tr> <tr> <th scope="row">允许的内容</th> <td> <a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#短语内容" >短语内容</a >,但它的后代元素中不能有 <code><meter></code> 元素。 </td> </tr> <tr> <th scope="row">标签省略</th> <td>不允许,开始标签和结束标签都不能省略。</td> </tr> <tr> <th scope="row">允许的父元素</th> <td> 任何接受<a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#短语内容" >短语内容</a >的元素。 </td> </tr> <tr> <th scope="row">隐含的 ARIA 角色</th> <td> <code ><a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/structural_roles#结构角色与_HTML_的对应关系">meter</a ></code > </td> </tr> <tr> <th scope="row">允许的 ARIA 角色</th> <td>没有允许的 <code>role</code></td> </tr> <tr> <th scope="row">DOM 接口</th> <td>HTMLMeterElement</td> </tr> </tbody> </table>
规范
浏览器兼容性
参见
- 创建垂直表单控件
- progress
- ::-webkit-meter-bar、::-webkit-meter-inner-element、::-webkit-meter-even-less-good-value、::-webkit-meter-optimum-value、::-webkit-meter-suboptimum-value:非标准的伪元素
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
