CKTIS / HTML
checked: zaznaczenie domyślne i aktualne
Rozróżniaj wartości domyślne, zmiany użytkownika i reset formularza.
Wersja: HTML Living Standard
Składnia
<input type="checkbox" name="topic" value="html" checked>Atrybut logiczny checked określa domyślne zaznaczenie pola wyboru lub przycisku radiowego. Decyduje obecność, więc checked="false" nadal oznacza zaznaczoną wartość domyślną. W jednej grupie przycisków radiowych aktualnie zaznaczony może być tylko jeden; checkbox wybiera się niezależnie. Ten atrybut nie służy do wartości domyślnych zwykłych pól tekstowych.
Po interakcji rozróżniaj aktualną właściwość DOM checked i defaultChecked, która odzwierciedla atrybut domyślny. Zmiana atrybutu nie zastępuje niezawodnie ustawienia bieżącego stanu po zmianie kontrolki przez użytkownika. Reset formularza odtwarza wartości domyślne. Niezaznaczony checkbox jest pomijany w zwykłych danych formularza, a nie wysyłany jako logiczny fałsz.
Przykład zaczyna od zaznaczenia, aktywuje kontrolkę, aby je usunąć, sprawdza przesyłany zestaw pól i resetuje formularz. Wynik pokazuje zarówno pominięcie niezaznaczonego pola, jak i powrót do zaznaczonego stanu domyślnego. Pośredni wygląd checkboxa jest osobną właściwością ustawianą skryptem, nie trzecią wartością atrybutu.
Przykłady
<!doctype html><meta charset="utf-8">
<form id="form"><label><input id="topic" type="checkbox" name="topic" value="html" checked> HTML</label></form>
<output id="result"></output><script>
const field = document.querySelector('#topic'), form = document.querySelector('#form');
const initial = field.checked;
field.click();
const afterClick = field.checked, submitted = new FormData(form).has('topic');
form.reset();
document.querySelector('#result').textContent = 'initial=' + initial + '; afterClick=' + afterClick + '; submitted=' + submitted + '; afterReset=' + field.checked + '; default=' + field.defaultChecked;
</script>Wynik
initial=true; afterClick=false; submitted=false; afterReset=true; default=true
Sprawdzenie danych formularza dotyczy obecności nazwanego pola, a nie tego, czy jego tekstowa wartość jest równa true.