HTMLInputElement : propriété checked
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La propriété checked de l'interface HTMLInputElement indique l'état actuel de sélection de l'élément ; c'est-à-dire si le contrôle de formulaire est coché ou non.
La propriété booléenne checked concerne les types d'entrée radio (<input type="radio">) et checkbox (<input type="checkbox">).
La présence de l'attribut HTML checked indique que la case à cocher est cochée par défaut. Cela n'indique pas si cette case est actuellement cochée : si l'état de la case change, cet attribut de contenu ne reflète pas le changement ; seule la propriété IDL checked de HTMLInputElement est mise à jour. L'attribut checked est reflété par la propriété defaultChecked.
Lorsque la propriété checked d'un bouton radio est à true, toutes les autres entrées radio ayant le même name sont à false. Si un bouton radio dans un groupe de boutons radio portant le même nom est required, tant qu'un bouton du groupe est checked, la propriété en lecture seule valueMissing de l'objet ValidityState pour chaque bouton radio du groupe sera à false.
La valeur d'une case à cocher n'est incluse dans les données envoyées lors de la soumission du formulaire que si checked est à true. La valeur de la propriété HTMLInputElement.indeterminate n'a aucun effet sur la valeur de checked d'une case à cocher.
Valeur
Un booléen.
Exemples
const inputElement = document.getElementById("contactMail");
console.log(inputElement.checked);
inputElement.checked = true;
Spécifications
| Specification |
|---|
| HTML # dom-input-checked |
Compatibilité des navigateurs
Voir aussi
- L'élément HTML
<input> - La propriété
HTMLInputElement.validity - La pseudo-classe CSS
:checked