CKTIS / JavaScript
Wyłączone kontrolki formularza
Disabled form controls to wyłączone kontrolki formularza: użytkownik nie może ich obsługiwać ani ustawić na nich fokusu, a ich wartości nie są wysyłane. W JavaScript właściwość disabled pozwala przełączać własny stan wyłączenia 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
control.disabled = true;
control.disabled = false;
control.matches(':disabled');Disabled form controls oznacza wyłączone kontrolki formularza. Użytkownik nie może ich edytować ani aktywować kliknięciem; nie otrzymują fokusu i nie uczestniczą w walidacji ograniczeń. Ich wartości są pomijane przy wysyłaniu formularza. To mechanizm HTML i przeglądarkowego DOM, a nie funkcja konkretnej edycji ECMAScript. MDN oznacza HTMLInputElement.disabled jako szeroko dostępne w przeglądarkach od lipca 2015 r.; obecność Node 24 nie dowodzi obsługi DOM.
Właściwość input.disabled jest wartością logiczną odzwierciedlającą własny atrybut disabled elementu. Przypisanie true dodaje ten atrybut, a false go usuwa. Atrybut jest logiczny: nawet disabled="false" oznacza wyłączenie, ponieważ liczy się jego obecność, nie tekstowa wartość.
Wyłączony fieldset wyłącza także kontrolki potomne, z wyjątkiem tych wewnątrz pierwszego elementu legend będącego jego bezpośrednim dzieckiem. Samo umieszczenie kontrolki w legend zagnieżdżonego fieldset nie chroni jej przed wyłączeniem przez zewnętrzny fieldset. Dlatego input.disabled może wynosić false, choć kontrolka pozostaje wyłączona przez przodka; do sprawdzenia efektywnego stanu użyj input.matches(':disabled'). Samo ustawienie input.disabled = false nie znosi wyłączenia narzuconego przez fieldset.
Nie myl disabled z readonly: obsługujące go pola tylko do odczytu nadal mogą otrzymać fokus i przekazać wartość w formularzu. readonly dotyczy tekstowych typów input oraz textarea, a nie na przykład select lub button. Przykład pokazuje przełączanie disabled i wynikające z niego pomijanie pola w FormData.
Przykłady
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'));Wynik
true false JavaScript
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.