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. |
Tag omission | 不允许,开始标签和结束标签都不能省略。 |
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 content
<p>Heat the oven to <meter min="200" max="500" value="350">350 degrees</meter>.</p>
输出
在Google Chrome浏览器上, 计量器结果如下:
高低值区间示例
注意本例中min属性被省略,这是允许的,默认值为0。
HTML content
<p>He got a <meter low="69" high="80" max="100" value="84">B</meter> on the exam.</p>
输出
Google Chrome浏览器中,计量器显示效果如下:
规范
Specification | Status | Comment |
---|---|---|
WHATWG HTML Living Standard <meter> |
Living Standard | |
HTML5 <meter> |
Recommendation | Initial definition |
浏览器兼容
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Edge | Opera | Safari |
---|---|---|---|---|---|---|---|
Basic support | 6.0 | (Yes) | 16.0 (16.0) | 未实现 | 20[1] | 11.0 | 5.2 |
Feature | Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Edge Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|
Basic support | 未实现 | (Yes) | 16.0 (16.0) | 未实现 | 20[1] | 11.0 | 未实现 |
[1] See the Microsoft Edge Platform Status page.