Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Deaktivace ovládacích prvků formuláře HTML pomocí `disabled`

`disabled` deaktivuje ovládací prvek formuláře HTML a vyřadí ho z validace i z dat formuláře. Vlastnost `.disabled` a selektor `:disabled` zjišťují různé věci.

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

Syntaxe

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

disabled je booleovský atribut HTML: rozhoduje jeho přítomnost, takže prvek deaktivuje i disabled="false". Platí například pro input, button, select, textarea a vlastní prvky přidružené k formuláři. Pro option a optgroup platí samostatná pravidla: v deaktivované skupině optgroup nelze vybírat možnosti, samotný select se tím však nedeaktivuje.

Deaktivovaný fieldset deaktivuje podřízené ovládací prvky kromě těch uvnitř prvního prvku legend, který je jeho přímým potomkem, pokud takový existuje. U prvku input odráží .disabled pouze jeho vlastní atribut: true ho přidá a false odebere. Skutečný stav, včetně vlivu prvku fieldset, zjistíš pomocí input.matches(":disabled").

Uživatel nemůže deaktivovanému prvku předat fokus ani ho běžně ovládat, ale skript stále může změnit například input.value. Prohlížeč tento prvek vynechá při validaci omezení i při sestavování dat formuláře, a to i při použití new FormData(form). U textových polí, která podporují readonly, tento atribut zakáže uživatelské úpravy a vyřadí pole z validace omezení. Sám o sobě ale nebrání získání fokusu ani zahrnutí pole do dat formuláře.

Jde o funkce webové platformy, nikoli ECMAScriptu. Deaktivace není bezpečnostní opatření: data i oprávnění kontroluj na serveru.

Příklady

<!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>

Výsledek

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

Každý řádek postupně ukazuje `.disabled`, shodu s `:disabled`, `.willValidate` a přítomnost položky `city`. Po opětovném povolení prvku `fieldset` se změní poslední tři výsledky; vstupní pole nikdy nemá vlastní atribut `disabled`.

Související lekce

  • JavaScript · Lekce 20 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 21 · Středně pokročilá · Verze: 3

Zdroje