CKTIS / HTML
checked : sélection par défaut et sélection actuelle
Comprenez les valeurs initiales des cases et boutons radio, les changements et la réinitialisation du formulaire.
Version : HTML Living Standard
Syntaxe
<input type="checkbox" name="topic" value="html" checked>L’attribut booléen checked donne à une case à cocher ou à un bouton radio son état coché par défaut. La présence compte : checked="false" fournit donc encore un état coché par défaut. Les boutons radio d’un même groupe n’autorisent qu’une sélection actuelle ; une case se sélectionne indépendamment. Cet attribut ne définit pas la valeur par défaut des champs de texte ordinaires.
Après interaction, distinguez la propriété DOM actuelle checked de defaultChecked, qui reflète l’attribut par défaut. Modifier l’attribut ne remplace pas de façon fiable la modification de l’état actuel une fois que le contrôle a été modifié. Réinitialiser le formulaire restaure les valeurs par défaut. Une case non cochée est omise des données ordinaires du formulaire, plutôt qu’envoyée comme le booléen false.
L’exemple commence coché, active le contrôle pour le décocher, examine les champs transmis puis réinitialise le formulaire. La sortie montre l’omission pendant l’état décoché et le rétablissement de la sélection par défaut. L’état visuel mixte d’une case est une propriété distincte contrôlée par script, pas une troisième valeur de l’attribut.
Exemples
<!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>Résultat
initial=true; afterClick=false; submitted=false; afterReset=true; default=true
La vérification des données porte sur la présence du champ nommé, pas sur l’égalité de sa valeur textuelle avec true.