Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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 disabled

input.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