Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

max — górna granica wartości

Atrybut max określa górną granicę dla wybranych typów input, skali meter lub postępu progress. Format wartości, wartości domyślne i skutki przekroczenia granicy zależą od elementu.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

input: max="upper-bound"; meter: max="number"; progress: max="positive-number"

max określa górną granicę, nie długość tekstu — do niej służy maxlength. W input dotyczy typów number, range, date, month, week, time i datetime-local. Wartość musi odpowiadać formatowi typu, np. 10, 2026-12-31 lub 18:00.

Dla zwykłego zakresu wartość większa niż maksimum powoduje validity.rangeOverflow. max nie gwarantuje zablokowania wpisania takiej wartości. Brak lub błędna wartość oznacza brak maksimum, chyba że typ definiuje domyślne: dla range jest to 100, a jego wartość jest ograniczana do zakresu. Zwykle max nie może być mniejsze niż min; wyjątkiem jest time, gdzie odwrócony zakres może obejmować północ.

W meter atrybut określa koniec skali pomiarowej i musi być poprawną liczbą zmiennoprzecinkową, nie mniejszą niż min. Przeglądarka przyjmuje zastępcze maksimum 1, gdy atrybutu brakuje lub nie daje się go odczytać, i podnosi efektywne maksimum do minimum, jeśli potrzeba.

W progress max oznacza całkowitą ilość pracy i musi być poprawną liczbą większą od zera. Brak lub błędna wartość daje maksimum 1. Brak value oznacza postęp nieokreślony, nawet przy ustawionym max. Używaj meter do pomiarów, a progress do postępu zadania.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>max</title>
<label>Input: <input id="quantity" type="number" max="10" value="11"></label>
<label>Meter: <meter id="gauge" min="0" max="10" value="7">7/10</meter></label>
<label>Progress: <progress id="task" max="10" value="7">7/10</progress></label>
<pre id="result"></pre>
<script>
  const quantity = document.getElementById('quantity');
  const gauge = document.getElementById('gauge');
  const task = document.getElementById('task');
  document.getElementById('result').textContent = [
    `rangeOverflow: ${quantity.validity.rangeOverflow}`,
    `meter max: ${gauge.max}`,
    `progress position: ${task.position}`
  ].join('\n');
</script>

Wynik

rangeOverflow: true
meter max: 10
progress position: 0.7

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła