CKTIS / HTML
checked: selezione predefinita e selezione corrente
Comprendi i valori iniziali di checkbox e radio, le modifiche dell’utente e il ripristino del modulo.
Versione: HTML Living Standard
Sintassi
<input type="checkbox" name="topic" value="html" checked>L’attributo booleano checked assegna a una checkbox o a un radio il relativo stato selezionato predefinito. Conta la presenza, quindi anche checked="false" indica un valore predefinito selezionato. I radio dello stesso gruppo consentono una sola selezione corrente; una checkbox è selezionabile indipendentemente. Questo attributo non definisce il valore predefinito dei normali campi di testo.
Dopo l’interazione, distingui la proprietà DOM corrente checked da defaultChecked, che riflette l’attributo predefinito. Modificare l’attributo non sostituisce in modo affidabile la modifica dello stato corrente dopo che il controllo è stato modificato. Ripristinare il modulo ristabilisce i valori predefiniti. Una checkbox non selezionata viene omessa dai normali dati del modulo, anziché essere inviata come booleano false.
L’esempio parte selezionato, attiva il controllo per deselezionarlo, esamina i campi inviati e ripristina il modulo. L’output mostra sia l’omissione durante la deselezione sia il ritorno alla selezione predefinita. Lo stato visivo misto di una checkbox è una proprietà separata controllata da script, non un terzo valore dell’attributo.
Esempi
<!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>Risultato
initial=true; afterClick=false; submitted=false; afterReset=true; default=true
Il controllo dei dati riguarda la presenza del campo denominato, non l’uguaglianza del suo valore testuale a true.