CKTIS / JavaScript
Zakázané ovládacie prvky formulára
Používatelia nemôžu zakázané ovládacie prvky formulára používať ani na ne presunúť fokus a ich hodnoty sa neodosielajú. V JavaScripte vlastnosť `disabled` prepína vlastný stav zakázania prvku; zakázať ho môže aj nadradený `fieldset`.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
control.disabled = true;
control.disabled = false;
control.matches(':disabled');Zakázané ovládacie prvky formulára sú prvky formulára, ktoré boli zakázané. Používatelia ich nemôžu upravovať ani aktivovať kliknutím; nemôžu získať fokus a nezúčastňujú sa na validácii obmedzení. Ich hodnoty sa pri odoslaní formulára vynechajú. Ide o mechanizmus HTML a DOM prehliadača, nie o funkciu konkrétnej edície ECMAScriptu. MDN uvádza, že HTMLInputElement.disabled je v prehliadačoch široko dostupné od júla 2015; prítomnosť Node 24 nedokazuje podporu DOM.
Vlastnosť input.disabled je logická hodnota, ktorá odráža vlastný atribút disabled daného prvku. Priradenie true tento atribút pridá a priradenie false ho odstráni. Atribút je logický: aj disabled="false" znamená zakázaný, pretože záleží na prítomnosti atribútu, nie na jeho textovej hodnote.
Zakázaný fieldset zakáže aj ovládacie prvky vo svojom podstrome okrem tých, ktoré sa nachádzajú v jeho prvom prvku legend, ktorý je jeho priamym potomkom. Samotné umiestnenie ovládacieho prvku v prvku legend vnoreného fieldset nezabráni tomu, aby ho vonkajší fieldset zakázal. Preto môže mať input.disabled hodnotu false, hoci ovládací prvok stále zakazuje predok; jeho efektívny stav skontrolujte pomocou input.matches(':disabled'). Samotné nastavenie input.disabled = false nezruší zakázanie spôsobené prvkom fieldset.
Nezamieňajte disabled s readonly: podporované polia iba na čítanie môžu stále získať fokus a odovzdať svoje hodnoty pri odoslaní formulára. readonly sa vzťahuje na textové typy input a na textarea, nie napríklad na select alebo button. Príklad ukazuje prepínanie disabled a následné vynechanie poľa z FormData.
Príklady
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'));Výsledok
true false JavaScript
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.