Naar de inhoud
Gratis naslagwerk over HTML
HTML leren en naslaan
Naslag / Formulieren

Het element <meter>

Het <meter>-HTML-element vertegenwoordigt ofwel een scalaire waarde binnen een bekend bereik, ofwel een fractionele waarde.

Code
<label for="fuel">Fuel level:</label>

<meter id="fuel" min="0" max="100" low="33" high="66" optimum="80" value="50">
  at 50/100
</meter>
Resultaat in de browser

Attributen

Dit element bevat de globale attributen.

value

De huidige numerieke waarde. Deze moet tussen de minimum- en maximumwaarde liggen (min-attribuut en max-attribuut), indien gespecificeerd. Als deze niet is opgegeven of onjuist is geformatteerd, is de waarde 0. Als deze wel is opgegeven, maar niet binnen het bereik valt dat door het min-attribuut en max-attribuut wordt gegeven, is de waarde gelijk aan het dichtstbijzijnde uiteinde van het bereik.

Opmerking

Tenzij het value-attribuut tussen 0 en 1 (inclusief) ligt, moeten de min- en max-attributen het bereik zo definiëren dat de waarde van het value-attribuut erbinnen valt.

min

De ondergrens van het gemeten bereik. Deze moet kleiner zijn dan de maximumwaarde (max-attribuut), indien opgegeven. Als deze niet is opgegeven, is de minimumwaarde 0.

max

De bovengrens van het gemeten bereik. Deze moet groter zijn dan de minimumwaarde (min-attribuut), indien opgegeven. Als deze niet is opgegeven, is de maximumwaarde 1.

low

De bovengrens van het lage einde van het gemeten bereik. Deze moet groter zijn dan de minimumwaarde (min-attribuut), en moet ook kleiner zijn dan de hoge waarde en de maximumwaarde (respectievelijk high-attribuut en max-attribuut), indien opgegeven. Als deze niet is opgegeven, of kleiner is dan de minimumwaarde, is de waarde van low gelijk aan de minimumwaarde.

high

De ondergrens van het hoge einde van het gemeten bereik. Deze moet kleiner zijn dan de maximumwaarde (max-attribuut), en moet ook groter zijn dan de lage waarde en de minimumwaarde (respectievelijk low-attribuut en min-attribuut), indien opgegeven. Als deze niet is opgegeven, of groter is dan de maximumwaarde, is de waarde van high gelijk aan de maximumwaarde.

optimum

Dit attribuut geeft de optimale numerieke waarde aan. Deze moet binnen het bereik liggen (zoals gedefinieerd door het min-attribuut en max-attribuut). Wanneer gebruikt met het low-attribuut en high-attribuut, geeft het aan waar in het bereik de voorkeur ligt. Als het bijvoorbeeld tussen het min-attribuut en het low-attribuut ligt, dan wordt het lagere bereik als voorkeur beschouwd. De browser kan de balk van de meter anders kleuren, afhankelijk van of de waarde kleiner dan of gelijk aan de optimale waarde is.

Voorbeelden

Eenvoudig voorbeeld

HTML

HTML
<p>Battery level: <meter min="0" max="100" value="75">75%</meter></p>

Resultaat

Resultaat in de browser

Voorbeeld met hoog en laag bereik

Merk op dat in dit voorbeeld het min-attribuut is weggelaten. Dit is toegestaan, aangezien het standaard 0 is.

HTML

HTML
<p>
  Student's exam score:
  <meter low="50" high="80" max="100" value="84">84%</meter>
</p>

Resultaat

Resultaat in de browser

Technische samenvatting

Content categories Flow content, phrasing content, labelable content, palpable content.
Toegestane inhoud Phrasing content, maar er mag geen <meter>-element onder de afstammelingen ervan zijn.
Weglaten van tags Geen, zowel de begin- als de eindtag zijn verplicht.
Toegestane ouders Elk element dat phrasing content accepteert.
Impliciete ARIA-rol meter
Toegestane ARIA-rollen Geen role toegestaan
DOM-interface HTMLMeterElement

Zie ook

Verwante elementen