Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła