<meter>

Summary

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

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

Attributes

This element includes the global attributes.

value
The current numeric value. This must be between the minimum and maximum values (min attribute and max attribute) if they are specified. If unspecified or malformed, the value is 0. If specified, but not within the range given by the min attribute and max attribute, the value is equal to the nearest end of the range.
min
The lower numeric bound of the measured range. This must be less than the maximum value (max attribute), if specified. If unspecified, the minimum value is 0.
max
The upper numeric bound of the measured range. This must be greater than the minimum value (min attribute), if specified. If unspecified, the maximum value is 1.
low
The upper numeric bound of the low end of the measured range. This must be greater than the minimum value (min attribute), and it also must be less than the high value and maximum value (high attribute and max attribute, respectively), if any are specified. If unspecified, or if less than the minimum value, the low value is equal to the minimum value.
high
The lower numeric bound of the high end of the measured range. This must be less than the maximum value (max attribute), and it also must be greater than the low value and minimum value (low attribute and min attribute, respectively), if any are specified. If unspecified, or if greater than the maximum value, the high value is equal to the maximum value.
optimum
This attribute indicates the optimal numeric value. It must be within the range (as defined by the min attribute and max attribute). When used with the low attribute and high attribute, it gives an indication where along the range is considered preferable. For example, if it is between the min attribute and the low attribute, then the lower range is considered preferred.
form
This attribute associates the element with a form element that has ownership of the meter element. For example, a meter might be displaying a range corresponding to an input element of type number. This attribute is only used if the meter element is being used as a form-associated element; even then, it may be omitted if the element appears as a descendant of a form element.

Examples

Simple example

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

On Google Chrome, the resulting meter looks like this:

meter1.png

High and Low range example

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

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

On Google Chrome, the resulting meter looks like this:

meter2.png

Specifications

Specification Status Comment
WHATWG HTML Living Standard Living Standard  
HTML5 Candidate Recommendation  

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 6.0 16.0 (16.0) bug 555985 Not supported 11.0 5.2
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support Not supported 16.0 (16.0) bug 555985 Not supported 11.0 Not supported

See also

Attachments

File Size Date Attached by
meter1.png
6385 bytes 2011-01-29 18:07:28 Sheppy
meter2.png
6309 bytes 2011-01-29 18:09:12 Sheppy
switch: radio - on (danger)
1494 bytes 2013-02-24 13:40:23 Sheppy

Document Tags and Contributors

Last updated by: kscarfone,