Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Onemogočanje kontrolnikov obrazca HTML z `disabled`

`disabled` onemogoči kontrolnik obrazca HTML ter ga izloči iz preverjanja veljavnosti in podatkov obrazca. Lastnost `.disabled` in izbirnik `:disabled` preverjata različni stvari.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

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

disabled je logični atribut HTML: šteje njegova prisotnost, zato element onemogoči tudi disabled="false". Velja denimo za input, button, select, textarea in elemente po meri, povezane z obrazcem. Za option in optgroup veljajo ločena pravila: v onemogočenem optgroup možnosti ni mogoče izbrati, sam select pa zaradi tega ni onemogočen.

Onemogočeni fieldset onemogoči kontrolnike v svojem poddrevesu, razen tistih znotraj prvega elementa legend, ki je njegov neposredni otrok, če obstaja. Pri input lastnost .disabled odraža le njegov lastni atribut: true ga doda, false pa odstrani. Z input.matches(":disabled") preveri dejansko stanje, vključno z učinkom elementa fieldset.

Uporabnik onemogočenemu kontrolniku ne more dati fokusa ali ga uporabljati na običajen način, lahko pa skript še vedno spremeni na primer input.value. Brskalnik kontrolnik preskoči pri preverjanju omejitev vnosa in sestavljanju podatkov obrazca, tudi z new FormData(form). V besedilnih poljih, ki podpirajo readonly, ta atribut prepreči uporabnikovo urejanje in polje izloči iz preverjanja omejitev, sam po sebi pa ne prepreči fokusa ali vključitve v podatke obrazca.

To so funkcije spletne platforme, ne ECMAScripta. Onemogočanje ni varnostni ukrep: podatke in dovoljenja preverjaj na strežniku.

Primeri

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

Rezultat

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

Vsaka vrstica po vrsti pokaže `.disabled`, ujemanje z `:disabled`, `.willValidate` in prisotnost vnosa `city`. Ko znova omogočiš `fieldset`, se spremenijo zadnji trije rezultati; vnosno polje nikoli nima lastnega atributa `disabled`.

Povezane lekcije

  • JavaScript · Lekcija 20 · Srednja · Različica: 3
  • JavaScript · Lekcija 21 · Srednja · Različica: 3

Viri