meter

Sumário

O elemento HTML meter (<meter>) pode representar um valor escalar dentro de um intervalo conhecido ou um valor fracionário.

Note: A não ser que o atributo value esteja entre 0 e 1(inclusive), o atributo min e o atributo max devem definir o intervalo de modo que o valor do atributo value esteja dentro dele.

Contexto de uso

Content categories flow content, phrasing content, Labelable Form-associated content
Conteúdo permitido Phrasing content, mas nenhum elemento meter descendente.
Tag omission Nenhuma, ambas as tags iniciais e finais são obrigatórias.
Elementos pais permitidos Qualquer elemento que aceite phrasing content.
Documento normativo HTML5, section 4.10.8

Atributos

Como todos os elementos HTML, esse elemento suporta attributes.

value

O valor numérico atual. Ele deve estar entre os valores mínimos e máximo (o atributo min e o atributo max) se eles estiverem especificados. Se não especificado ou mal formatado, o valor é 0. Se especificado, mas fora do intervalo dado pelos atributos min e max, o valor é igual ao extremo do intervalo mais próximo.

min

O limite numérico mínimo do intervalo medido. Deve ser menor que o valor máximo (o atributo max), se especificado. Se não especificado, o valor mínimo é 0.

max

O limite numérico máximo do intervalo medido. Deve ser maior que o valor mínimo (o atributo min), se especificado. Se não especificado, o valor máximo é 1.

low

O limite numérico máximo da parte inferior do intervalo medido. Deve ser maior que o valor mínimo (o atibuto min), e também ser menor que o valor alto e o valor máximo (os atributos high e max, respectivamente), se estiver especificado. Se não especificado, ou se for menor que o valor mínimo, o valor de low é igual ao valor mínimo.

high

O limite numérico mínimo da parte superior do intervalo medido. Deve ser menor que o valor máximo (o atibuto max), e também ser maior que o valor baixo e o valor mínimo (os atributos low e min, respectivamente), se estiver especificado. Se não especificado, ou se for maior que o valor máximo, o valor de high é igual ao valor máximo.

optimum

Esse atributo indica o valor numérico ótimo. Deve estar dentro do intervalo (definido pelos atributos min e max). Quando com os atributos low e high, ele indica a região do intervalo qu é considerada preferível. Por exemplo, se estiver entre os atributos min e low, então a parte inferior do intervalo é considerada como ótima.

form

Esse atributo associa o elemento com um elemento form que é dono de um elemento meter. Por exemplo, um elemento meter pode estar mostrando um intervalo correspondente a um elemento input do type(tipo) number. Esse atributo só é utilizado se o elemento meter está sendo utilizado como um elemento associado a um formulário; mesmo assim, ele pode se romitido se o elemento for um descendente de um elemento form.

Exemplos

Exemplo simples

html
<p>
  Aqueça o forno para <meter min="200" max="500" value="350">350 graus</meter>.
</p>

No Google Chrome, o medidor aparece como:

meter1.png

Exemplos de intervalos com High e Low

Note que nesse exemplo o atributo min foi omitido; isso é permitido, pois ele irá ser, por padrão, 0.

html
<p>
  Ele recebeu <meter low="69" high="80" max="100" value="84">B</meter> no exame.
</p>

No Google Chrome, o medidor aparece como:

meter2.png

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também