Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

HTMLButtonElement.disabled — zakázání tlačítka

HTMLButtonElement.disabled je logická vlastnost, která odráží přítomnost atributu disabled u tlačítka. Umožňuje tlačítko zakázat nebo odebrat jeho vlastní atribut disabled, ale nepopisuje všechny důvody, proč může být ovládací prvek zakázán.

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

button.disabled; button.disabled = true; button.disabled = false;

HTMLButtonElement.disabled je čitelná a zapisovatelná logická vlastnost rozhraní tlačítka. Odráží vlastní atribut disabled tlačítka: přiřazením true se atribut přidá, zatímco false jej odebere. Jde o API prohlížeče definované v HTML Standard, nikoli o funkci samotného ECMAScriptu; dostupnost Node 24 nedokládá podporu tohoto API.

Zakázané tlačítko nereaguje na běžnou aktivaci uživatelem a jeho dvojice název–hodnota se neodesílá s formulářem. Atribut je logický: záleží na jeho přítomnosti, nikoli na textové hodnotě. Proto button.setAttribute('disabled', 'false') tlačítko stále zakáže; atribut odeberete pomocí button.disabled = false.

Hodnota vlastnosti není úplným testem skutečného zakázání. Tlačítko může mít disabled === false, a přesto může být zakázáno nadřazeným fieldset s atributem disabled. Výjimka ze zakázání tímto prvkem fieldset platí pro potomky prvního prvku legend mezi jeho přímými potomky. Samotné nastavení button.disabled = false nezruší zakázání zděděné od předka.

Příklady

const button = document.createElement('button');
button.type = 'button';
console.log(button.disabled);

button.disabled = true;
console.log(button.disabled, button.hasAttribute('disabled'));

button.disabled = false;
console.log(button.disabled, button.hasAttribute('disabled'));

button.setAttribute('disabled', 'false');
console.log(button.disabled);

Výsledek

false
true true
false false
true

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.

Zdroje