CKTIS / HTML
checked: voreingestellte und aktuelle Auswahl
Verstehe Vorgaben für Checkboxen und Radiobuttons, Benutzeränderungen und das Zurücksetzen des Formulars.
Version: HTML Living Standard
Syntax
<input type="checkbox" name="topic" value="html" checked>Das boolesche Attribut checked legt den voreingestellten Auswahlzustand einer Checkbox oder eines Radiobuttons fest. Entscheidend ist seine Anwesenheit: Auch checked="false" gibt einen ausgewählten Standardzustand vor. Radiobuttons derselben Gruppe erlauben nur eine aktuelle Auswahl; eine Checkbox ist unabhängig auswählbar. Für gewöhnliche Textfelder definiert dieses Attribut keinen Standardwert.
Unterscheide nach einer Interaktion die aktuelle DOM-Eigenschaft checked von defaultChecked, welche das Standardattribut widerspiegelt. Sobald das Feld einen geänderten Zustand hat, ersetzt eine Attributänderung nicht zuverlässig die Änderung des aktuellen Zustands. Das Zurücksetzen des Formulars stellt die Vorgaben wieder her. Eine nicht ausgewählte Checkbox wird in gewöhnlichen Formulardaten ausgelassen und nicht als boolesches false übermittelt.
Das Beispiel beginnt ausgewählt, aktiviert das Feld zum Abwählen, prüft die übermittelten Felder und setzt das Formular zurück. Die Ausgabe zeigt sowohl das Auslassen im abgewählten Zustand als auch die Wiederherstellung der voreingestellten Auswahl. Ein gemischter visueller Checkboxzustand ist eine gesonderte, skriptgesteuerte Eigenschaft und kein dritter Attributwert.
Beispiele
<!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>Ergebnis
initial=true; afterClick=false; submitted=false; afterReset=true; default=true
Die Formulardatenprüfung betrifft das Vorhandensein des benannten Feldes, nicht die Frage, ob dessen Textwert true lautet.