CKTIS / JavaScript
Zakázané ovládací prvky formuláře
Uživatelé nemohou zakázané ovládací prvky formuláře používat ani na ně přesunout fokus a jejich hodnoty se neodesílají. V JavaScriptu vlastnost `disabled` přepíná vlastní stav zakázání prvku; zakázat jej může také nadřazený `fieldset`.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
control.disabled = true;
control.disabled = false;
control.matches(':disabled');Zakázané ovládací prvky formuláře jsou prvky formuláře, které byly zakázány. Uživatelé je nemohou upravovat ani aktivovat kliknutím; nemohou získat fokus a neúčastní se ověřování omezení. Jejich hodnoty se při odeslání formuláře vynechají. Jde o mechanismus HTML a DOM prohlížeče, nikoli o funkci konkrétní edice ECMAScriptu. MDN uvádí, že HTMLInputElement.disabled je v prohlížečích široce dostupné od července 2015; přítomnost Node 24 nedokazuje podporu DOM.
Vlastnost input.disabled je logická hodnota, která odráží vlastní atribut disabled daného prvku. Přiřazení true tento atribut přidá a přiřazení false jej odstraní. Atribut je logický: i disabled="false" znamená zakázaný, protože záleží na přítomnosti atributu, nikoli na jeho textové hodnotě.
Zakázaný fieldset zakáže také ovládací prvky ve svém podstromu, kromě těch uvnitř prvního prvku legend, který je jeho přímým potomkem. Samotné umístění ovládacího prvku uvnitř prvku legend vnořeného fieldset nezabrání tomu, aby ho vnější fieldset zakázal. Proto může mít input.disabled hodnotu false, i když ovládací prvek stále zakazuje předek; jeho skutečný stav ověřte pomocí input.matches(':disabled'). Samotné nastavení input.disabled = false nezruší zakázání způsobené prvkem fieldset.
Nezaměňujte disabled a readonly: podporovaná pole pouze pro čtení mohou stále získat fokus a předat své hodnoty při odeslání formuláře. readonly se vztahuje na textové typy input a na textarea, nikoli například na select nebo button. Příklad ukazuje přepínání disabled a následné vynechání pole z FormData.
Pří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ýsledek
true false JavaScript
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.