CKTIS / HTML
meter — measurement within a known range
The `meter` element represents a numeric value within a known range, such as disk usage. It is not intended to display task progress.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<meter min="0" max="100" value="65" low="20" high="80" optimum="50">65 / 100</meter>meter represents a measurement within a known range or a fraction of a whole. For task progress, use progress, not meter.
The required value specifies the measurement; min and max define the bounds. If min is omitted, the effective minimum is 0. If max is omitted, the effective maximum is 1 unless the effective minimum exceeds 1, in which case the maximum equals that minimum. Supply valid numbers satisfying min <= value <= max.
Optional low and high divide the scale into regions, while optimum identifies the optimal value, not another measurement. Keep min <= low <= high <= max; optimum must also be within the range. The position of optimum determines which region is best.
Associate a label using for and id. Include fallback text inside the element; express units in text. Both tags are required, and nesting meter is prohibited. The gauge's appearance depends on the browser.
Examples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Meter example</title>
<label for="storage">Storage used</label>
<meter id="storage" min="0" max="100" value="65"
low="20" high="80" optimum="10">65 / 100 GB</meter>
<p>65 / 100 GB</p>
</html>Result
Storage used [Gauge representing 65 on a scale from 0 to 100] 65 / 100 GB
The displayed code and declared result were verified in an isolated environment using the method recorded in the verification evidence for this exact version.