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

CKTIS / JavaScript

Onemogočeni kontrolniki obrazca

Uporabniki onemogočenih kontrolnikov obrazca ne morejo uporabljati ali jim dati fokusa, njihove vrednosti pa se ne pošljejo. V JavaScriptu lastnost `disabled` preklaplja lastno stanje onemogočenosti kontrolnika, onemogoči pa ga lahko tudi nadrejeni `fieldset`.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

control.disabled = true;
control.disabled = false;
control.matches(':disabled');

Onemogočeni kontrolniki obrazca so kontrolniki obrazca, ki so onemogočeni. Uporabniki jih ne morejo urejati ali aktivirati s klikom; ne morejo prejeti fokusa in ne sodelujejo pri preverjanju omejitev. Njihove vrednosti se pri pošiljanju obrazca izpustijo. To je mehanizem HTML in DOM-a brskalnika, ne funkcija določene izdaje ECMAScripta. MDN navaja, da je HTMLInputElement.disabled v brskalnikih široko podprt od julija 2015; prisotnost Node 24 ne dokazuje podpore za DOM.

Lastnost input.disabled je logična vrednost, ki odraža lastni atribut disabled elementa. Z dodelitvijo true se atribut doda, z dodelitvijo false pa odstrani. Atribut je logičen: tudi disabled="false" pomeni, da je element onemogočen, saj je pomembna prisotnost atributa, ne njegova besedilna vrednost.

Onemogočeni fieldset onemogoči tudi podrejene kontrolnike, razen tistih znotraj prvega elementa legend, ki je njegov neposredni otrok. Če je kontrolnik znotraj elementa legend v vgnezdenem fieldset, ga lahko zunanji fieldset še vedno onemogoči. Zato je lahko input.disabled enak false, čeprav kontrolnik še vedno onemogoča prednik; njegovo dejansko stanje preverite z input.matches(':disabled'). Sama nastavitev input.disabled = false ne odpravi onemogočenosti, ki jo povzroči fieldset.

Ne zamenjujte disabled z readonly: podprta polja samo za branje lahko še vedno prejmejo fokus in prispevajo svoje vrednosti k pošiljanju obrazca. readonly velja za besedilne vrste input in za textarea, ne pa na primer za select ali button. Primer prikazuje preklapljanje disabled in posledično izpuščanje polja iz FormData.

Primeri

const form = document.createElement('form');
const input = document.createElement('input');
input.name = 'topic';
input.value = 'JavaScript';
form.append(input);

input.disabled = true;
console.log(input.disabled);
console.log(new FormData(form).has('topic'));

input.disabled = false;
console.log(new FormData(form).get('topic'));

Rezultat

true
false
JavaScript

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri