This page was translated from English by the community.Learn more and join the MDN Web Docs community.
<meter>
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since март 2017 г..
HTML-элемент<meter> представляет собой скалярное значение в пределах известного диапазона или дробного значения.
In this article
Интерактивный пример
<label for="fuel">Fuel level:</label><meter min="0" max="100" low="33" high="66" optimum="80" value="50"> at 50/100</meter>label { padding-right: 10px; font-size: 1rem;}| Категории контента | Потоковый контент,фразовый контент, контент, ассоциированный с label, явный контент. |
|---|---|
| Допустимое содержимое | Фразовый контент, но среди его потомков не должно быть элемента<meter>. |
| Пропуск тегов | Нет, открывающий и закрывающий теги обязательны. |
| Допустимые родители | Любой элемент, который принимаетфразовый контент. |
| Допустимые ARIA-роли | Нет |
| DOM-интерфейс | HTMLMeterElement |
Атрибуты
Этот элемент включает в себяглобальные атрибуты.
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сtypenumber. Этот атрибут используется только в случае, если элемент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, результат будет выглядеть приблизительно так:

Спецификации
| Specification |
|---|
| HTML> # the-meter-element> |