<meter>

Интерактивный пример

<label for="fuel">Fuel level:</label>

<meter id="fuel" min="0" max="100" low="33" high="66" optimum="80" value="50">
  at 50/100
</meter>

label {
  padding-right: 10px;
  font-size: 1rem;
}

Атрибуты

Этот элемент включает в себя глобальные атрибуты.

value

Текущее числовое значение. Он должен быть между минимальным и максимальным значением (min атрибут и max атрибут), если они указаны. Если он не указан или имеет неверное значение, значение равно 0. Если указан, но не в пределах диапазона, заданного атрибутами min и max, значение будет равно ближайшему концу диапазона.

Примечание: Если атрибут value не находится в диапазоне от 0 до 1 (включительно), то атрибуты min и max должны определять диапазон, в котором будет находиться значение value.

min

Нижняя числовая граница измеряемого диапазона. Он должен быть меньше, чем максимальное значение (max атрибут), если указан. Если не определён, то минимальное значение равно 0.

max

Верхняя числовая граница измеряемого диапазона. Он должен быть больше, чем минимальное значение (min атрибут), если указан. Если не определён, то максимальное значение равно 1.

low

Верхняя числовая граница нижнего предела измеряемого диапазона. Он должен быть больше, чем минимальное значение (min атрибут), а также, меньше, чем значение high и максимальное значение(high атрибут и max атрибут, соответственно), если они указаны. Если не указан или меньше минимального значения, то значение low равно минимальному значению.

high

Нижняя числовая граница верхнего предела измеряемого диапазона. Он должен быть меньше, чем максимальное значение (max атрибут), а также, больше, чем значение low и минимальное значение (low атрибут и min атрибут, соответственно), если они указаны. Если не указан или больше максимального значения, то значение high равно максимальному значению.

optimum

Этот атрибут указывает оптимальное числовое значение. Он должен находиться в пределах диапазона (который определён атрибутами min и max). При использовании с атрибутами low и high, он указывает какая часть диапазона является предпочтительной. Например, если он находится между атрибутами min и low, нижний диапазон является предпочтительным.

form

Этот атрибут связывает элемент с элементом form, частью которого является элемент meter. Например, meter может отображать диапазон, соответствующий элементу input с type number. Этот атрибут используется только в случае, если элемент meter используется как элемент, связанный с формой; даже в этом случае он может быть опущен, если элемент является потомком элемента form.

Примеры

Простой пример

HTML

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

Результат

В Google Chrome, результат будет выглядеть приблизительно так:

Пример с диапазоном

Обратите внимание, что в этом примере атрибут min опущен; это разрешено, так как по умолчанию он будет равен 0.

HTML

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

Результат

В Google Chrome, результат будет выглядеть приблизительно так:

Спецификации

Совместимость с браузерами

Смотрите также

• <progress>