Pas à pas

L'attribut aria-hidden : quand l'utiliser, et que faire quand Tab atteint ce qu'il cache

7 min de lecture
Mikhail ShaymardanovExpert en Qualité et Accessibilité Web

Les liens qu'aria-hidden="true" cache au lecteur d'écran, la personne au clavier les atteint encore avec la touche Tab. L'attribut retire l'élément de l'arbre d'accessibilité, la version de la page que lisent les lecteurs d'écran, sans toucher à l'écran ni au clavier. Il convient à une icône décorative. Un panneau fermé qui garde des liens se cache avec hidden ou inert, et le focus n'y entre plus.

Cacher un panneau sans y perdre le focus


#À quoi sert l'attribut aria-hidden="true" ?

L'attribut aria-hidden="true" retire un élément et tout son contenu de l'arbre d'accessibilité, la version de la page que le navigateur transmet aux lecteurs d'écran. Il tait au lecteur d'écran ce que la page dit déjà : une icône à côté d'un mot, un texte doublé comme le « 33 T » d'un disquaire. MDN, la documentation de référence de Mozilla, ne l'admet que si les aides techniques reçoivent ailleurs un sens et une fonction équivalents.

Sur la page « Bottines » de l'Atelier Corbière, un bottier de démo, le lien « Toute la collection → » cache ainsi sa flèche. Dans l'arbre d'accessibilité de Chrome, nous avons relevé le nom « Toute la collection ». Sans l'attribut, cette flèche, un simple caractère de texte, entre dans le nom du lien.

Capture d'écran : Chrome sur la page Bottines de l'Atelier Corbière, l'en-tête avec le lien « Toute la collection → » et, dessous, les outils de développement qui affichent l'arbre d'accessibilité, où le lien sélectionné s'appelle « Toute la collection ».Repère 1. La flèche du lien, visible à l'écran. Repère 2. Le lien et son texte dans l'arbre d'accessibilité, « Toute la collection », sans la flèche.
À l'écran, la flèche suit « Toute la collection »repère 1 ; dans l'arbre d'accessibilité de Chrome, le lien et son texte s'arrêtent à « Toute la collection »repère 2, car la flèche porte aria-hidden.

L'attribut ne fait rien d'autre : l'élément reste affiché, ses liens et ses boutons à portée de Tab. MDN et le guide d'accessibilité de Chrome l'excluent donc de tout élément qui peut recevoir le focus, et de ses parents, puisqu'il vaut pour tout leur contenu. Les autres façons de cacher ont leur fiche, contenu caché.

Sur la même page, le panier latéral porte l'attribut sur tout le panneau, avec son bouton de fermeture et ses trois liens, dont « Commander ». C'est ce panneau que Lighthouse signale.

L'attribut aria-label : quand l'utiliser et comment l'écrire

#Pourquoi Lighthouse et Chrome signalent-ils une zone aria-hidden où le focus peut entrer ?

La touche Tab entre encore dans une zone aria-hidden : Lighthouse et axe, son moteur de tests, le signalent, et la console de Chrome avertit quand le focus y arrive. Un panneau latéral qui s'ouvre par-dessus la page respecte trois règles :

  • fermé, il sort de la touche Tab et de l'arbre d'accessibilité ;
  • ouvert, Tab et Maj+Tab restent dans le panneau ;
  • refermé, il rend le focus au bouton qui l'a ouvert.

Pour une fenêtre modale, le RGAA donne cette deuxième règle en exemple, dans la méthode de son critère sur l'ordre de tabulation. Côté WCAG, axe range l'alerte sous le critère « Nom, rôle et valeur ».

#Que se passe-t-il au clavier dans une zone aria-hidden ?

Fermé, le panier de la démo attend hors de l'écran, sous aria-hidden="true". L'ordre de tabulation y entre pourtant après le dernier bouton visible : pendant quatre appuis sur Tab, la personne qui se sert du clavier ne voit plus son focus.

Cliquez sur la démo, puis appuyez sur la touche indiquée, ou avancez avec « Étape suivante ». Échap fait sortir de la démo.
5 étapes

Panier fermé : après le dernier bouton visible, quatre appuis sur Tab passent par des éléments que personne ne voit.

Lighthouse n'échoue alors qu'à un audit, sur l'<aside> du panier. La note d'accessibilité ne descend qu'à 95 : quatre appuis perdus hors de l'écran ne coûtent que cinq points. L'audit s'intitule « Les éléments [aria-hidden="true"] contiennent des descendants sélectionnables ». C'est la règle aria-hidden-focus d'axe, que l'extension axe DevTools signale aussi et classe grave (« serious »).

À l'ouverture, le script grise la page et pose aria-hidden="true" sur son contenu principal, <main>. Depuis « Panier (2) », Tab parcourt pourtant d'abord les quatre liens et boutons de la page grisée. Axe n'y compte plus d'erreur : il voit un voile couvrir l'écran, suppose une fenêtre modale et range <main> parmi les points à vérifier à la main.

#Que veut dire « Blocked aria-hidden » dans la console de Chrome ?

Chrome écrit cet avertissement quand un élément qui a le focus se trouve dans une zone aria-hidden="true". Lighthouse et axe repèrent le défaut dès le chargement, la console seulement quand le focus y arrive, ici au premier appui de Tab dans le panier fermé de la démo :

Blocked aria-hidden on an element because its descendant retained focus. The focus must not be hidden from assistive technology users. Avoid using aria-hidden on a focused element or its ancestor. Consider using the inert attribute instead, which will also prevent focus. For more details, see the aria-hidden section of the WAI-ARIA specification at https://w3c.github.io/aria/#aria-hidden.
Element with focus: <button.fermer#fermer>
Ancestor with aria-hidden: <aside.tiroir#panier>

Le message conseille lui-même inert, qui bloque aussi le focus.

Dès ce premier appui, tout le panier réapparaît dans l'arbre de Chrome : son titre, le bouton qui a le focus et les trois liens que Tab n'a pas encore atteints. Le mot « Blocked » du message le disait : Chrome a écarté l'aria-hidden du panneau entier. La zone que l'attribut devait taire revient donc dans ce que reçoivent les lecteurs d'écran, dès que quelqu'un l'atteint.

Capture d'écran : les outils de développement de Chrome ; en haut, l'arbre d'accessibilité de la page, avec une zone complementary qui contient le titre Votre panier, le bouton Fermer le panier marqué focused et le lien Commander ; en bas, la console et un avertissement jaune qui commence par Blocked aria-hidden.Repère 1. Le panier revenu dans l'arbre d'accessibilité : la zone complementary, son titre, le bouton Fermer le panier, la liste des deux liens et le lien Commander. Repère 2. L'avertissement Blocked aria-hidden dans la console.
Avec le focus sur « Fermer le panier », Chrome remet tout le panier dans son arbre d'accessibilitérepère 1 et l'écrit dans la consolerepère 2.
Thème Shopify « accessible » : ce que Shopify a vérifié, et ce qu'il reste à tester

#Que mettre à la place d'aria-hidden : hidden, inert ou dialog ?

Un panneau qui s'ouvre par-dessus la page se refait en <dialog>. Ouvert par showModal(), il rend le reste de la page inerte : ni le clavier, ni la souris, ni le lecteur d'écran n'y ont plus accès. Faute de <dialog>, hidden et inert prennent le relais, et aria-hidden reste réservé à ce qui ne reçoit jamais le focus.

#Comment remplacer aria-hidden par un dialog ?

Le guide de Chrome sur le tiroir de navigation fait du panneau latéral un <dialog> modal, pris en charge par les principaux navigateurs depuis mars 2022. Refait ainsi, notre panier fermé sort de la tabulation. Ouvert, il met le focus sur « Fermer le panier », et Tab ne parcourt que ses quatre éléments et l'interface du navigateur. Refermé par son bouton ou par Échap, il rend le focus à « Panier (2) ».

Capture d'écran : le panier de l'Atelier Corbière ouvert à droite, avec deux bottines, le total et le lien Commander ; à gauche, la page grisée, où le bouton Ajouter au panier porte un contour de focus.Repère 1. La page grisée derrière le panier, où Tab a posé le focus sur « Ajouter au panier ».
Derrière le panier ouvert, la page griséerepère 1 reste à portée de Tab avec aria-hidden sur main ; avec un dialog ouvert par showModal(), Tab ne passe plus par la page, et l'écran reste le même.

À éviter

<button id="ouvrir" type="button" aria-expanded="false">Panier (2)</button>
<main id="contenu">…</main>
<aside id="panier" class="tiroir" aria-hidden="true">
  <h2>Votre panier</h2>
  <button id="fermer" type="button">Fermer le panier</button>
  …
</aside>
<script>
  const ouvrir = document.querySelector("#ouvrir");
  const panier = document.querySelector("#panier");
  ouvrir.onclick = () => {
    document.querySelector("#contenu").setAttribute("aria-hidden", "true");
    panier.removeAttribute("aria-hidden");
    panier.classList.add("ouvert");
    ouvrir.setAttribute("aria-expanded", "true");
  };
</script>

Correct

<button id="ouvrir" type="button" aria-expanded="false">Panier (2)</button>
<main id="contenu">…</main>
<dialog id="panier" class="tiroir" aria-labelledby="panier-titre">
  <h2 id="panier-titre">Votre panier</h2>
  <button id="fermer" type="button">Fermer le panier</button>
  …
</dialog>
<script>
  const ouvrir = document.querySelector("#ouvrir");
  const panier = document.querySelector("#panier");
  ouvrir.onclick = () => {
    panier.showModal();
    ouvrir.setAttribute("aria-expanded", "true");
  };
  panier.querySelector("#fermer").onclick = () => panier.close();
  panier.onclose = () => ouvrir.setAttribute("aria-expanded", "false");
</script>

Le navigateur fait tout cela seul, sans script pour le focus. Chrome demande donc, dans son guide sur les dialogues, de n'ajouter ni role="dialog", ni aria-modal, ni script qui retient le focus ou gère Échap, ni bascule d'inert.

#Quand passer à hidden ou à inert ?

Chrome conseille inert quand le <dialog> est impossible : un framework qui l'empêche, une mise en page que gênent sa position et son affichage au-dessus de tout, certains panneaux superposés qui ne bloquent pas la page.

  • Fermé, le panneau prend hidden, qui le retire de l'écran, de l'arbre et de Tab : inutile d'y ajouter aria-hidden. S'il doit rester dans la page pour glisser, inert le retire de Tab, de la souris et de l'arbre, comme le conseille Chrome.
  • Ouvert et fait à la main, il passe tout le reste de la page en inert, ici <main> et l'en-tête : Tab ne parcourt plus que le panier. Rien ne signale à l'écran une zone inerte, d'où la page grisée.

À la fermeture, rendez le focus au bouton « Panier (2) », comme le demande Chrome, puis cachez le panneau. Sans ce retour, aria-hidden laisse le focus sur « Fermer le panier », caché avec le panneau. Avant de rendre le focus, retirez inert de la page, en-tête compris : sur la démo, le bouton encore inerte refusait le focus.

function fermerPanier() {
  document.querySelector("main").inert = false;
  document.querySelector("header").inert = false; // « Panier (2) » redevient atteignable
  ouvrir.focus(); // le focus revient sur ce bouton
  ouvrir.setAttribute("aria-expanded", "false");
  panier.hidden = true; // puis le panneau se cache
}

#Comment vérifier que la correction tient ?

Vérifiez d'abord avec la touche Tab, car le CSS du panneau peut défaire la correction. Sur notre démo, le display: flex du panneau l'emportait sur hidden comme sur le <dialog> fermé, et Tab entrait encore dans le panier. Avec hidden, axe ne signalait plus rien, faute d'aria-hidden à tester. Une règle CSS par état fermé a retiré le panier pour de bon :

/* Panier en <dialog> : fermé, il n'a pas l'attribut open */
dialog.tiroir:not([open]) { display: none; }
/* Panier caché par l'attribut hidden */
.tiroir[hidden] { display: none; }

Sur la page corrigée, Tab s'arrête aux sept éléments visibles, panier fermé, et ne parcourt que le panier une fois ouvert. La console reste vide, axe ne signale rien et Lighthouse remonte à 100. Le panier fermé a disparu de l'arbre de Chrome, et sur toute la page, aria-hidden="true" ne reste que sur la flèche décorative de « Toute la collection ».

Test d'accessibilité d'un site web avec Google : ce que compte la note de 100

Sur un site en ligne, le scan d'Includdy liste les zones aria-hidden où Tab atteint un lien ou un bouton. Pour chacune, sa correction guidée met le HTML fautif à côté d'un composant corrigé par l'IA d'Includdy, à relire avant de l'intégrer.


Partagez cet article

Questions fréquentes

Non. La règle d'axe que fait tourner Lighthouse vérifie qu'aucun élément de la zone cachée ne figure dans l'ordre de Tab, où que se trouve le focus. Sur notre démo, sans le voile qui grisait la page, un script qui retenait le focus gardait bien Tab dans le panier ouvert, et axe signalait toujours <main>.

Axe demande seulement une vérification à la main quand il croit voir une fenêtre ouverte. Il la reconnaît à un <dialog>, un role="dialog", un aria-modal="true" ou un voile qui couvre au moins les trois quarts de l'écran, en largeur comme en hauteur. Dans tous les cas, remplacez aria-hidden par inert, ou ouvrez la fenêtre avec showModal().

Axe et la règle ACT du W3C l'acceptent, par exemple sur la photo d'une carte produit qui mène à la même page que son titre : avec tabindex="-1", ce lien sort de l'ordre de Tab.

MDN le déconseille pourtant, puisqu'un clic ou un script peut encore lui donner le focus. Pour un panneau entier, préférez hidden ou inert ; les trois valeurs de tabindex ont leur fiche.

aria-hidden="true" retire l'élément entier, contenu compris, de ce que reçoivent les lecteurs d'écran. role="presentation" ou role="none" ne retire que le rôle de l'élément et laisse son contenu exposé aux lecteurs d'écran.