Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Wyłączanie kontrolek formularza HTML: `disabled`

Atrybut `disabled` wyłącza kontrolkę formularza HTML i wyklucza ją z walidacji oraz danych formularza. Właściwość `.disabled` i selektor `:disabled` odpowiadają na różne pytania.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

<input name="city" disabled>
<script>
  const input = document.querySelector('input[name="city"]');
  input.disabled = true;
  input.disabled = false;
  input.matches(":disabled");
</script>

disabled to atrybut logiczny HTML: liczy się jego obecność, więc nawet disabled="false" wyłącza element. Dotyczy to m.in. elementów input, button, select, textarea i elementów niestandardowych powiązanych z formularzem. Elementy option i optgroup mają odrębne reguły: wyłączony optgroup blokuje wybór swoich opcji, ale sam nie wyłącza select.

Wyłączony fieldset wyłącza kontrolki potomne z wyjątkiem tych, które znajdują się wewnątrz pierwszego elementu legend będącego jego bezpośrednim dzieckiem. W przypadku input właściwość .disabled odzwierciedla tylko własny atrybut kontrolki: true go dodaje, a false usuwa. Użyj input.matches(":disabled"), aby sprawdzić rzeczywisty stan, także wynikający z fieldset.

Użytkownik nie może ustawić fokusu na wyłączonej kontrolce ani obsługiwać jej w zwykły sposób, ale skrypt nadal może zmienić np. input.value. Przeglądarka pomija wyłączoną kontrolkę podczas walidacji ograniczeń i tworzenia danych formularza, także w new FormData(form). Natomiast readonly, w obsługujących go polach tekstowych, blokuje edycję przez użytkownika i wyklucza pole z walidacji ograniczeń, ale samo nie odbiera fokusu ani nie wyklucza pola z danych formularza.

To mechanizm platformy WWW, nie funkcja ECMAScript. Nie stanowi zabezpieczenia: dane i uprawnienia należy sprawdzać na serwerze.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Disabled form control</title>
</head>
<body>
  <script>
    const form = document.createElement("form");
    const group = document.createElement("fieldset");
    const input = document.createElement("input");
    input.name = "city";
    input.value = "Oslo";
    group.append(input);
    form.append(group);

    const report = () => console.log(JSON.stringify([
      input.disabled,
      input.matches(":disabled"),
      input.willValidate,
      new FormData(form).has("city")
    ]));

    group.disabled = true;
    report();
    group.disabled = false;
    report();
  </script>
</body>
</html>

Wynik

[false,true,false,false]
[false,false,true,true]

Każdy wiersz pokazuje kolejno: `.disabled`, dopasowanie do `:disabled`, `.willValidate` oraz obecność wpisu `city`. Po włączeniu `fieldset` zmieniają się trzy ostatnie wyniki; pole przez cały czas nie ma własnego atrybutu `disabled`.

Powiązane lekcje

  • JavaScript · Lekcja 20 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 21 · Średniozaawansowany · Wersja: 3

Źródła