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

CKTIS / JavaScript

Interactions accessibles en JavaScript

Une interaction accessible associe l’utilisation au clavier, un focus prévisible et un état compréhensible par les technologies d’assistance. JavaScript doit synchroniser la visibilité avec ARIA et communiquer les mises à jour sans déplacer inutilement le focus.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

element.setAttribute('aria-expanded', String(expanded));
panel.hidden = !expanded;
trigger.focus();
status.textContent = message;

Une interaction accessible permet d’utiliser une interface sans souris et d’en comprendre les changements à l’aide des technologies d’assistance. Commencez par des boutons natifs : ils fournissent une sémantique et une activation au clavier. ARIA décrit l’interface, mais n’ajoute pas de comportement à elle seule. La spécification ECMAScript décrit le langage et le distingue de son environnement hôte ; la source fournie ne définit ni le DOM, ni HTML, ni ARIA.

La gestion de l’état ARIA et du focus clavier consiste à synchroniser l’état, la visibilité et le focus. Dans l’exemple, aria-expanded correspond à l’inverse de panel.hidden, tandis que aria-controls désigne panel. Lors du test d’ouverture, le focus est déjà sur le bouton Details et y reste ; le panneau n’est pas une boîte de dialogue modale. Le gestionnaire d’événement de Close details place le focus sur Details avant de masquer le panneau. Lorsque Details ferme le panneau et que le focus se trouve encore dans celui-ci, setExpanded le ramène sur Details avant de masquer le panneau. Le test en console couvre les deux modes de fermeture, dont l’activation de Details sans y déplacer le focus au préalable. Ne supprimez pas l’indicateur de focus visible et n’utilisez pas de valeurs positives de tabindex pour corriger l’ordre de navigation.

Les annonces des régions live ARIA communiquent les mises à jour sans déplacer le focus. L’exemple met à jour textContent dans une région existante dotée de role="status". Ce rôle confère implicitement le comportement associé à aria-live="polite" ; aucun attribut aria-live n’est défini dans le balisage. L’attribut aria-atomic="true" indique que tout le contenu de la région doit être traité comme le message. La région existe avant la mise à jour. Ne l’utilisez pas à la place des libellés des commandes et n’annoncez pas chaque changement mineur. Les paroles exactes et le moment de l’annonce dépendent du navigateur et de la technologie d’assistance.

Enregistrez l’exemple dans un fichier HTML et vérifiez l’utilisation au clavier, les valeurs des attributs et les annonces du lecteur d’écran. Le résultat attendu décrit l’état du DOM et l’emplacement du focus, sans garantir ce que dira le lecteur d’écran. L’exemple a été exécuté dans un environnement Chromium isolé et la sortie de la console correspondait exactement à la sortie attendue. Il utilise la syntaxe ECMAScript 2015 et des interfaces de navigateur ; la prise en charge dans l’environnement cible doit être vérifiée séparément. Node 24 dans le dépôt ne prouve pas la prise en charge de ces interfaces.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Accessible disclosure</title>
</head>
<body>
  <button id="toggle" type="button" aria-expanded="false" aria-controls="panel">Details</button>
  <section id="panel" aria-label="Details" hidden>
    <p>Additional information.</p>
    <button id="close" type="button">Close details</button>
  </section>
  <p id="status" role="status" aria-atomic="true"></p>
  <script>
    const toggle = document.getElementById('toggle');
    const panel = document.getElementById('panel');
    const closeButton = document.getElementById('close');
    const statusMessage = document.getElementById('status');

    function setExpanded(expanded) {
      if (!expanded && panel.contains(document.activeElement)) {
        toggle.focus();
      }
      panel.hidden = !expanded;
      toggle.setAttribute('aria-expanded', String(expanded));
      statusMessage.textContent = expanded ? 'Details opened.' : 'Details closed.';
    }

    toggle.addEventListener('click', () => setExpanded(panel.hidden));
    closeButton.addEventListener('click', () => {
      toggle.focus();
      setExpanded(false);
    });

    function report(step) {
      console.log(`${step}: hidden=${panel.hidden}; aria-expanded=${toggle.getAttribute('aria-expanded')}; status=${JSON.stringify(statusMessage.textContent)}`);
    }

    report('Initial');
    toggle.focus();
    toggle.click();
    report('Open');
    console.log('Open kept focus on Details: ' + (document.activeElement === toggle));

    // Test closing when activation does not first focus the close button.
    toggle.blur();
    console.log('Focus inside panel before close: ' + panel.contains(document.activeElement));
    closeButton.click();
    report('Close');
    console.log('Focus returned to Details: ' + (document.activeElement === toggle));

    // Test closing with Details while focus remains inside the panel.
    toggle.click();
    closeButton.focus();
    console.log('Focus inside panel before closing with Details: ' + panel.contains(document.activeElement));
    toggle.click();
    report('Close with Details');
    console.log('Focus returned to Details: ' + (document.activeElement === toggle));
  </script>
</body>
</html>

Résultat

Initial: hidden=true; aria-expanded=false; status=""
Open: hidden=false; aria-expanded=true; status="Details opened."
Open kept focus on Details: true
Focus inside panel before close: false
Close: hidden=true; aria-expanded=false; status="Details closed."
Focus returned to Details: true
Focus inside panel before closing with Details: true
Close with Details: hidden=true; aria-expanded=false; status="Details closed."
Focus returned to Details: true

Le test active `Details` par programmation alors que le focus est sur `Close details`. Le focus doit revenir sur `Details` avant que le panneau soit masqué.

Sources