<meter>:HTML Meter 元素

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

¥The <meter> HTML element represents either a scalar value within a known range or a fractional value.

Try it

属性

¥Attributes

该元素包括 全局属性

¥This element includes the global attributes.

value

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

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

¥Note: Unless the value attribute is between 0 and 1 (inclusive), the min and max attributes should define the range so that the value attribute's value is within it.

min

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

max

测量范围的数值上限。如果指定,该值必须大于最小值(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>(如果有)上的 <fieldset>)上的 form 属性设置的表单关联相关联。如果包含,则该值必须是同一树中 <form>id

示例

¥Examples

简单的例子

¥Simple example

HTML

html
<p>
  Heat the oven to <meter min="200" max="500" value="350">350 degrees</meter>.
</p>

结果

¥Result

在 Google Chrome 上,生成的仪表如下所示:

¥On Google Chrome, the resulting meter looks like this:

A screenshot of the meter element in Google Chrome

高低范围示例

¥High and Low range example

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

¥Note that in this example the min attribute is omitted. This is allowed, as it will default to 0.

HTML

html
<p>
  He got a <meter low="69" high="80" max="100" value="84">B</meter> on the exam.
</p>

结果

¥Result

在 Google Chrome 上,生成的仪表如下所示:

¥On Google Chrome, the resulting meter looks like this:

red meter in Google Chrome

技术总结

¥Technical summary

内容类别 流量内容措辞内容,可标记内容,可触及内容。
允许的内容 措辞内容,但其后代中不得有 <meter> 元素。
标签遗漏 无,开始和结束标记都是强制性的。
允许的父级 任何接受 措辞内容 的元素。
隐式 ARIA 角色 meter
允许的 ARIA 角色 不允许 role
DOM 接口 HTMLMeterElement

规范

Specification
HTML Standard
# the-meter-element

¥Specifications

浏览器兼容性

BCD tables only load in the browser

¥Browser compatibility

也可以看看