Element HTML meter
reprezentuje wartość skalarną ze znanego przedziału lub liczbę zmiennoprzecinkową, np. poziom użycia dysku, poziom trafności wyniku wyszukiwania albo procent głosów oddanych na kandydata w wyborach.
Przykład użycia elementu HTML meter
Przykład użycia elementu HTML meter
:
<meter value=5 max=10>Wykonano 5 z 10</meter>
Kontekst użycia
Modele treści HTML5 | treść ogólna, syntagmatyczna, etykietowalna |
---|---|
Elementy nadrzędne | elementy treści syntagmatycznej |
Elementy potomne | |
Znaczniki | Znaczniki otwierający i zamykający są obowiązkowe |
Normy | HTML5 — podrozdział 4.10.17 |
Interfejs DOM | HTMLMeterElement |
Różnice między HTML 4.01 a HTML 5 | Element |
Obsługa przez przeglądarki
Firefox | Chrome | Opera | Safari | Internet Explorer |
---|---|---|---|---|
✘ | ✔ | ✔ | ✘ | ✘ |
Atrybuty obowiązkowe
Element meter
ma atrybut obowiązkowy value
.
Atrybuty opcjonalne
Atrybuty globalne oraz:
Atrybut | Opis |
---|---|
high | Określa dolną granicę przedziału wysokich wartości miernika. Wartość tego atrybutu musi być mniejsza od wartości atrybutu max oraz większa od atrybutów low i min . Jeśli atrybut ten nie zostanie zdefiniowany, lub jego wartość jest większa od wartości atrybutu max , domyślnie jego wartość jest równa max |
low | Określa górną granicę przedziału niskich wartości miernika. Wartość tego atrybutu musi być wyższa od wartości atrybutu min i mniejsza od atrybutów high i max . Jeśli atrybut ten nie zostanie zdefiniowany, lub jego wartość jest większa od wartości atrybutu min , domyślnie jego wartość jest równa min |
max | Określa górną granicę przedziału wartości elementu. Jeśli atrybut ten nie zostanie zdefiniowany, przyjmowana jest wartość 1 |
min | Określa dolną granicę przedziału wartości elementu. Jeśli atrybut ten nie zostanie zdefiniowany, przyjmowana jest wartość 0 |
optimum | Określa optymalną wartość w przedziale |
value | Określa bieżącą wartość elementu |
Jeśli nie zostaną zdefiniowane wartości maksymalna ani minimalna, odgórnie przyjmowany jest przedział 0..1 i wartości elementu muszę mieścić się w tym przedziale.
Ustawienia atrybutów low
i high
mają wpływ na wygląd kontrolki wyświetlonej na stronie. Jeśli np. w wartości elementu meter
zostanie przekroczona wartość atrybutu high
, to kontrolka na stronie zmieni kolor:
<meter low="20" high="80" max="100" value="81">81</meter>
<meter low="20" high="80" max="100" value="79">79</meter>
Uwagi
Elementu meter
nie należy używać do oznaczania postępu wykonywania procesów (np. pasków postępu instalacji). Do tego służy element progress.
Element meter
nie reprezentuje skalarnych wartości bez określonego przedziału, np. nie należy go używać do oznaczania wagi ani wysokości czegoś, chyba że znana jest wartość maksymalna tych wielkości.