<meter>

HTML-элемент <meter> представляет собой скалярное значение в пределах известного диапазона или дробного значения.

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

Категории контента (en-US) Потоковый контент, фразовый контент, контент, ассоциированный с label, явный контент.
Допустимое содержимое Фразовый контент, но среди его потомков не должно быть элемента <meter>.
Пропуск тегов Нет, открывающий и закрывающий теги обязательны.
Допустимые родители Любой элемент, который принимает фразовый контент.
Допустимые ARIA-роли Нет
DOM-интерфейс HTMLMeterElement (en-US)

Атрибуты

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

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

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

Результат

В 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, результат будет выглядеть приблизительно так:

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

Specification
HTML Standard
# the-meter-element

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

BCD tables only load in the browser

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