Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

aria-checked — état coché d’un contrôle

`aria-checked` décrit l’état coché d’un contrôle doté d’un rôle approprié ; il ne réalise pas le comportement d’une case à cocher.

Version : WAI-ARIA 1.2

Syntaxe

<button role="checkbox" aria-checked="mixed">All topics</button>

Pour une case à cocher, utilisez les chaînes true, false ou mixed. Un état absent est indéfini, et non décoché ; le rôle checkbox exige un état explicite. L’état mixte convient à un groupe partiellement sélectionné ; les rôles radio et switch ne le prennent pas en charge. Ce n’est pas un attribut booléen HTML activé par sa seule présence.

Préférez d’abord une case à cocher native. Un contrôle personnalisé exige gestion du clavier, focus, étiquette et apparence conforme à son état. Modifier ARIA seul ne coche pas les champs associés.

L’exemple utilise un bouton natif doté de la sémantique checkbox pour gérer un groupe. Un sujet est initialement coché ; l’activation coche les deux et passe l’état à vrai. Le test vérifie les champs réels et l’état de l’arbre d’accessibilité, pas une phrase précise d’un lecteur d’écran.

Exemples

<!doctype html><meta charset="utf-8">
<button id="all" role="checkbox" aria-checked="mixed">All topics</button>
<label><input class="topic" type="checkbox" checked> HTML</label>
<label><input class="topic" type="checkbox"> CSS</label>
<output id="result"></output>
<script>
const all = document.querySelector('#all');
const topics = [...document.querySelectorAll('.topic')];
function sync() {
  const n = topics.filter(input => input.checked).length;
  all.setAttribute('aria-checked', n === 0 ? 'false' : n === topics.length ? 'true' : 'mixed');
}
topics.forEach(input => input.addEventListener('change', sync));
all.addEventListener('click', () => {
  const checked = all.getAttribute('aria-checked') !== 'true';
  topics.forEach(input => { input.checked = checked; }); sync();
});
all.click();
document.querySelector('#result').textContent = 'selected=' + topics.filter(x => x.checked).length + '; checked=' + all.getAttribute('aria-checked');
</script>

Résultat

selected=2; checked=true

Le résultat montre deux sujets cochés et l’état true. Le gestionnaire de clic fournit le comportement, pas ARIA seul.

Sources