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

CKTIS / HTML

aria-expanded — état déployé ou replié

`aria-expanded` indique si le contenu contrôlé est déployé et doit correspondre à l’état réel de l’interface.

Version : WAI-ARIA 1.2

Syntaxe

<button aria-expanded="false" aria-controls="panel">Details</button>

Sur le bouton de déploiement, définissez la chaîne true ou false. L’absence d’état signifie que l’élément ne déclare pas de possibilité de déploiement. N’attribuez pas systématiquement un état replié aux feuilles d’un arbre.

Placez l’attribut sur le contrôle, pas uniquement sur le panneau révélé. La cible peut être identifiée par aria-controls. Un changement d’état seul n’affiche aucun contenu et ne fournit ni clic, ni gestion du clavier ou du focus.

L’exemple associe un bouton natif à un panneau masqué. Une seule fonction actualise visibilité et état ensemble, évitant leur divergence après activation. Le test vérifie le panneau visible et l’état déployé dans l’arbre d’accessibilité. Une nouvelle activation utilise la même fonction pour le replier.

Exemples

<!doctype html><meta charset="utf-8">
<button id="toggle" aria-expanded="false" aria-controls="panel">Details</button>
<section id="panel" hidden><h2>Course details</h2><p>Three short lessons.</p></section>
<output id="result"></output>
<script>
const button = document.querySelector('#toggle'), panel = document.querySelector('#panel');
button.addEventListener('click', () => {
  const expanded = button.getAttribute('aria-expanded') !== 'true';
  panel.hidden = !expanded;
  button.setAttribute('aria-expanded', String(expanded));
});
button.click();
document.querySelector('#result').textContent = 'expanded=' + button.getAttribute('aria-expanded') + '; visible=' + !panel.hidden;
</script>

Résultat

expanded=true; visible=true

Le résultat confirme l’ouverture réelle du panneau et une sémantique d’accessibilité cohérente.

Sources