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


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.
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'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.
Le second « Ajouter au panier », dernier élément visible.
« Fermer le panier », dans le panier caché : plus d'anneau à l'écran.
Le premier lien produit, invisible.
Le second lien produit, invisible.
Le lien « Commander », invisible ; l'appui suivant quitte la page.
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.
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.
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) ».
Repère 1. La page grisée derrière le panier, où Tab a posé le focus sur « Ajouter au panier ».À é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 ajouteraria-hidden. S'il doit rester dans la page pour glisser,inertle 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.


