CKTIS / JavaScript
HTMLButtonElement.disabled — wyłączanie przycisku
HTMLButtonElement.disabled to właściwość logiczna odzwierciedlająca obecność atrybutu disabled na przycisku. Pozwala wyłączyć przycisk lub usunąć jego własne wyłączenie, lecz nie opisuje wszystkich przyczyn niedostępności kontrolki.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
button.disabled; button.disabled = true; button.disabled = false;HTMLButtonElement.disabled jest odczytywalną i zapisywalną właściwością logiczną interfejsu przycisku. Odzwierciedla jego własny atrybut disabled: przypisanie true dodaje atrybut, a false go usuwa. Jest to API przeglądarki zdefiniowane w HTML Standard, a nie funkcja samego ECMAScript; dostępność Node 24 nie dowodzi obsługi tego API.
Wyłączony przycisk nie wykonuje zwykłej aktywacji użytkownika, a jego para nazwa–wartość nie jest wysyłana z formularzem. Atrybut jest logiczny: liczy się jego obecność, nie tekstowa wartość. Dlatego button.setAttribute('disabled', 'false') nadal wyłącza przycisk; użyj button.disabled = false, aby usunąć atrybut.
Wartość właściwości nie jest pełnym testem faktycznego wyłączenia. Przycisk może mieć disabled === false, lecz pozostawać wyłączony przez nadrzędny fieldset z atrybutem disabled. Wyjątek dotyczy potomków pierwszego elementu legend będącego dzieckiem tego fieldset. Samo ustawienie button.disabled = false nie znosi wyłączenia wynikającego z przodka.
Przykłady
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);Wynik
false true true false false true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.