CKTIS / JavaScript
HTMLInputElement.max i disabled: limit wartości i wyłączanie pola
`max` odzwierciedla zapis górnej granicy, a `disabled` — obecność atrybutu wyłączającego pole. Przekroczenie limitu to nie to samo co wyłączenie pola.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
input.max; // string: the max attribute, or "" if absent
input.max = "10"; // set the max attribute
input.removeAttribute("max");
input.disabled; // boolean: whether the input's own disabled attribute is present
input.disabled = true; // add the disabled attribute
input.disabled = false; // remove the disabled attribute
input.matches(":disabled"); // test whether the input is effectively disabledinput.max to zapisywalna właściwość tekstowa odzwierciedlająca atrybut HTML max. Odczyt zwraca zapis atrybutu lub "", gdy go nie ma, a nie obliczoną górną granicę. Przypisanie input.max = "10" ustawia atrybut; input.removeAttribute("max") go usuwa.
max ma znaczenie dla typów number, range, date, month, week, time i datetime-local; format zależy od typu. Nie ogranicza długości tekstu. Brak atrybutu lub wartość, której nie da się odczytać w formacie danego typu, oznacza użycie domyślnej granicy typu, jeśli istnieje: dla range to 100, dla number nie ma takiej granicy. W polu number liczba powyżej limitu pozostaje w value i powoduje validity.rangeOverflow === true. Suwak range dostosowuje wartość do zakresu. Zakres time z min większym niż max może przechodzić przez północ.
input.disabled to zapisywalna właściwość logiczna odzwierciedlająca obecność atrybutu disabled na samym polu. true dodaje atrybut, a false go usuwa. Zapis disabled="false" nadal wyłącza pole. Wyłączony fieldset też wyłącza pola potomne, z wyjątkiem tych wewnątrz jego pierwszego bezpośredniego dziecka legend. Dlatego input.disabled może zwracać false, choć input.matches(":disabled") zwraca true.
Użytkownik nie może edytować wyłączonego pola ani przenieść na nie fokusu, ale JavaScript nadal może zmienić jego wartość. Takie pole nie uczestniczy w walidacji ograniczeń (willValidate ma wartość false) i jest pomijane przy wysyłaniu formularza oraz tworzeniu new FormData(form). To właściwości przeglądarkowego DOM, nie część ECMAScript; środowisko bez DOM ich nie udostępni. Niezależnie od ustawień pola sprawdzaj odebrane dane na serwerze.
Przykłady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Input max and disabled</title>
</head>
<body>
<script>
const form = document.createElement('form');
const input = document.createElement('input');
input.type = 'number';
input.name = 'quantity';
input.max = '10';
input.value = '12';
form.append(input);
console.log(JSON.stringify([
input.max, input.value, input.validity.rangeOverflow,
input.checkValidity(), new FormData(form).has('quantity'),
]));
input.disabled = true;
console.log(JSON.stringify([
input.disabled, input.value, input.willValidate,
new FormData(form).has('quantity'),
]));
</script>
</body>
</html>Wynik
["10","12",true,false,true] [true,"12",false,false]
Zapisz przykład jako plik `.html`, otwórz go w przeglądarce i sprawdź wynik w konsoli. Wartość `"12"` przekracza limit `"10"` i nie przechodzi walidacji, ale `FormData` nadal ją uwzględnia. Po wyłączeniu pole zachowuje wartość, lecz jest pomijane przy walidacji i tworzeniu danych formularza.
Powiązane lekcje
- JavaScript · Lekcja 28 · Średniozaawansowany · Wersja: 3
Źródła
- HTMLInputElement: max property
- HTMLInputElement: disabled property
- HTML Standard — The min and max attributes
- HTML Standard — Range state (type=range)
- HTML Standard — Enabling and disabling form controls: the disabled attribute
- HTML Standard — Constructing the entry list
- Using HTML form validation and the Constraint Validation API