<meter>:HTML Meter 元素

<meter> HTML 元素表示已知范围内的标量值或分数。

试一试

属性

此元素包含 全局属性

value

当前数值。如果指定了最小值和最大值(min 属性和 max 属性),则此值必须介于最小值和最大值之间。如果未指定或格式错误,则值为 0。如果指定了,但不在 min 属性和 max 属性给定的范围内,则该值等于该范围的最近端点。

注意:除非 value 属性在 01(含)之间,否则 minmax 属性应定义范围,以便 value 属性的值在该范围内。

min

测量范围的下限数值。如果指定了,则此值必须小于最大值(max 属性)。如果未指定,则最小值为 0

max

测量范围的上限数值。如果指定了,则此值必须大于最小值(min 属性)。如果未指定,则最大值为 1

low

测量范围低端的上限数值。此值必须大于最小值(min 属性),并且还必须小于高值和最大值(分别为 high 属性和 max 属性),如果指定了任何值。如果未指定,或小于最小值,则 low 值等于最小值。

high

测量范围高端的较低数值边界。此值必须小于最大值(max 属性),并且如果指定了低值和最小值(分别为low 属性和min 属性),则还必须大于低值和最小值。如果未指定,或如果大于最大值,则high 值等于最大值。

最佳

此属性指示最佳数值。它必须在范围内(由min 属性和max 属性定义)。当与low 属性和high 属性一起使用时,它指示在范围内哪个位置被认为是首选。例如,如果它在min 属性和low 属性之间,则认为较低范围是首选。浏览器可能会根据值是否小于或等于最佳值来以不同的颜色显示仪表的条形。

表单

此可选属性用于为<meter> 元素显式设置一个<form> 所有者。如果省略,则<meter> 与其祖先<form> 元素相关联,或者与另一个祖先元素(例如<fieldset>)的form 属性设置的表单关联相关联(如果有)。如果包含,则该值必须是同一树中<form>id

示例

简单示例

HTML

html
<p>Battery level: <meter min="0" max="100" value="75">75%</meter></p>

结果

高低范围示例

请注意,在此示例中省略了min 属性。这是允许的,因为它将默认为0

HTML

html
<p>
  Student's exam score:
  <meter min="0" low="50" high="80" max="100" value="84">84%</meter>
</p>

结果

技术摘要

内容类别 流内容短语内容、可标记内容、可感知内容。
允许的内容 短语内容,但其后代中不能有<meter> 元素。
标签省略 无,开始和结束标签都是必须的。
允许的父元素 任何接受短语内容的元素。
隐式 ARIA 角色 meter
允许的 ARIA 角色 不允许使用role
DOM 接口 HTMLMeterElement

规范

规范
HTML 标准
# the-meter-element

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅