Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Deaktivácia ovládacích prvkov formulára HTML pomocou `disabled`

`disabled` deaktivuje ovládací prvok formulára HTML a vylúči ho z validácie aj z údajov formulára. Vlastnosť `.disabled` a selektor `:disabled` zisťujú odlišné veci.

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

Syntax

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

disabled je boolovský atribút HTML: rozhoduje jeho prítomnosť, takže prvok deaktivuje aj disabled="false". Platí napríklad pre input, button, select, textarea a vlastné prvky priradené k formuláru. Pre option a optgroup platia samostatné pravidlá: možnosti v deaktivovanom optgroup sa nedajú vybrať, no samotný select sa tým nedeaktivuje.

Deaktivovaný fieldset deaktivuje svoje vnorené ovládacie prvky okrem tých vnútri prvého prvku legend, ktorý je jeho priamym potomkom, ak taký existuje. Pri prvku input odráža .disabled iba jeho vlastný atribút: true ho pridá a false odstráni. Pomocou input.matches(":disabled") zistíš skutočný stav vrátane vplyvu prvku fieldset.

Používateľ nemôže deaktivovanému prvku odovzdať fokus ani ho bežne ovládať, ale skript môže stále zmeniť napríklad input.value. Prehliadač tento prvok vynechá pri validácii obmedzení aj pri zostavovaní údajov formulára vrátane použitia new FormData(form). V textových poliach, ktoré podporujú readonly, tento atribút bráni používateľovi v úpravách a vylúči pole z validácie obmedzení. Sám osebe však nebráni získaniu fokusu ani zahrnutiu poľa do údajov formulára.

Ide o funkcie webovej platformy, nie ECMAScriptu. Deaktivácia nie je bezpečnostné opatrenie: údaje aj oprávnenia overuj na serveri.

Prí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ýsledok

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

Každý riadok postupne ukazuje `.disabled`, zhodu s `:disabled`, `.willValidate` a prítomnosť položky `city`. Po opätovnom povolení prvku `fieldset` sa zmenia posledné tri výsledky; vstupné pole nikdy nemá vlastný atribút `disabled`.

Súvisiace lekcie

  • JavaScript · Lekcia 20 · Stredne pokročilá · Verzia: 3
  • JavaScript · Lekcia 21 · Stredne pokročilá · Verzia: 3

Zdroje