mozilla

meter

Introduced in HTML5

Sumário

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

Nota de uso: 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

<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.

<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 de navegadores

Recurso Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suporte básico 6.0 Não suportado bug 555985 Não suportado 11.0 Nightly build
Recurso Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Suporte básico Não suportado Não suportado bug 555985 Não suportado 11.0 Não suportado

Veja também

Etiquetas do documento e colaboradores

Contributors to this page: teoli, LeonardoPacheco, fellyph, viniciuspires, arthurpf
Última atualização por: teoli,