Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
meter
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since março de 2017.
Sumário
O elemento HTMLmeter (<meter>) pode representar um valor escalar dentro de um intervalo conhecido ou um valor fracionário.
Nota:A não ser que o atributovalue esteja entre 0 e 1(inclusive), o atributomin e o atributomax devem definir o intervalo de modo que o valor do atributovalue esteja dentro dele.
Contexto de uso
| Content categories | flow content,phrasing content,LabelableForm-associated content |
|---|---|
| Conteúdo permitido | Phrasing content, mas nenhum elementometer 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 suportaattributes.
valueO valor numérico atual. Ele deve estar entre os valores mínimos e máximo (o atributomin e o atributomax) se eles estiverem especificados. Se não especificado ou mal formatado, o valor é 0. Se especificado, mas fora do intervalo dado pelos atributosmin emax, o valor é igual ao extremo do intervalo mais próximo.
minO limite numérico mínimo do intervalo medido. Deve ser menor que o valor máximo (o atributomax), se especificado. Se não especificado, o valor mínimo é 0.
maxO limite numérico máximo do intervalo medido. Deve ser maior que o valor mínimo (o atributomin), se especificado. Se não especificado, o valor máximo é 1.
lowO limite numérico máximo da parte inferior do intervalo medido. Deve ser maior que o valor mínimo (o atibutomin), e também ser menor que o valor alto e o valor máximo (os atributoshigh emax, respectivamente), se estiver especificado. Se não especificado, ou se for menor que o valor mínimo, o valor delow é igual ao valor mínimo.
highO limite numérico mínimo da parte superior do intervalo medido. Deve ser menor que o valor máximo (o atibutomax), e também ser maior que o valor baixo e o valor mínimo (os atributoslow emin, respectivamente), se estiver especificado. Se não especificado, ou se for maior que o valor máximo, o valor dehigh é igual ao valor máximo.
optimumEsse atributo indica o valor numérico ótimo. Deve estar dentro do intervalo (definido pelos atributosmin emax). Quando com os atributoslow ehigh, ele indica a região do intervalo qu é considerada preferível. Por exemplo, se estiver entre os atributosmin elow, então a parte inferior do intervalo é considerada como ótima.
formEsse atributo associa o elemento com um elemento
formque é dono de um elementometer. Por exemplo, um elementometerpode estar mostrando um intervalo correspondente a um elementoinputdotype(tipo)number. Esse atributo só é utilizado se o elementometerestá sendo utilizado como um elemento associado a um formulário; mesmo assim, ele pode se romitido se o elemento for um descendente de um elementoform.
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:
Exemplos de intervalos com High e Low
Note que nesse exemplo o atributomin 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:
