<meter>

HTML <meter> 元素用来显示已知范围的标量值或者分数值。

尝试一下

Content categories Flow content, phrasing content, labelable content, palpable content.
Permitted content Phrasing content, but there must be no <meter> element among its descendants.
标签省略 不允许,开始标签和结束标签都不能省略。
Permitted parents Any element that accepts phrasing content.
Permitted ARIA roles None
DOM interface HTMLMeterElement

属性

该元素包含所有的全局属性.

value

当前的数值。如果设置了最小值和最大值(分别由 min 属性和 max 属性定义),它必须介于最小值和最大值之间。如果没有指定或者格式有误,值即为 0。如果给定的值不在最小值和最大值之间,它的值就等于它最接近的一端的值。

备注: 除非值域在 0 到 1(闭区间), 否则最小值和最大值属性需要定义,以保证 value 属性在值域范围内。换言之,默认的 min 和 max 值分别为 0 和 1。

min

值域的最小边界值。如果设置了,它必须比最大值要小。如果没设置,默认为 0。

max

值域的上限边界值。如果设置了,它必须比最小值要大。如果没设置,默认为 1。

low

定义了低值区间的上限值(译者注:如果 value 介于 min 和 low 之间,该元素就会表现出低值的视觉效果,value 落在 [min,low]、[high,max] 等不同的区间会使浏览器渲染该元素时出不同的视觉效果)。如果设置了,它必须比最小值属性大,并且不能超过 high 值和最大值。未设置或者比最小值还要小时,其值即为最小值。

high

定义了高值区间的下限值。如果设置了,它必须小于最大值,同时必须大于 low 值和最小值。如果没有设置,或者比最大值还大,其值即为最大值。

optimum

这个属性用来指示最优/最佳取值。它必须在正确的值域内(由最小值属性和最大值属性定义)。当使用了 low 和 high 属性时,它指明哪一个取值范围是更好的。例如,假设它介于最小值和 low 之间,那么 lower 区间就被认为是更佳的取值范围。

form

该属性将本元素与对应的 form 元素关联。例如,一个计量器可能用来显示某个数值输入框(input 元素,number 类型)的范围。只有当计量器元素被用作表单关联的元素时,该属性才应当被使用;即便如此,如果它作为表单的后代元素出现,它仍然有可能被省略。

示例

简单示例

HTML

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

结果

在 Google Chrome 浏览器上,计量器结果如下:

current look of 'meter' in Google Chrome

高低值区间示例

注意本例中 min 属性被省略,这是允许的,默认值为 0。

HTML

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

结果

Google Chrome 浏览器中,计量器显示效果如下:

red meter in Google Chrome

规范

Specification
HTML Standard
# the-meter-element

浏览器兼容性

BCD tables only load in the browser

参见