ARIA : rôle document
Le rôle document est destiné au contenu sélectionnable au sein des composants ou applications composites complexes pour lesquels les technologies d'assistance peuvent revenir à un mode de lecture.
Description
Le rôle document est destiné au conteneur principal contenant du contenu que les utilisateur·ice·s de technologies d'assistance peuvent vouloir parcourir en mode lecture. Il n'est utile que sur les sections sélectionnables au sein des composants ou applications composites complexes, le rôle document informe les technologies d'assistance de revenir au mode de lecture : le rôle document indique aux technologies d'assistance disposant de modes de lecture ou de navigation d'utiliser le mode document pour lire le contenu contenu dans cet élément.
<div role="application">
…
<div id="InfoText" role="document" tabindex="0">
<p>Du contenu informatif va ici.</p>
</div>
…
<button>Fermer</button>
</div>
Cet exemple montre une application avec quelques contrôles et un <div> sélectionnable avec un role de document contenant du texte informatif que l'utilisateur·ice de la technologie d'assistance peut lire en mode lecture lorsqu'il est sélectionné.
Par défaut, les pages Web sont traitées comme des documents ; les technologies d'assistance (TA) entrent en mode de navigation ou de lecture lorsqu'elles accèdent à une nouvelle page Web. Ce mode peut être modifié par divers rôles, y compris les rôles de composant et d'application. Le rôle document ramène les TA en mode de navigation ou de lecture.
Généralement placé dans un rôle d'application ou un autre rôle de composant interactif, le rôle document est utilisé pour indiquer une section d'un composant composite complexe que l'utilisateur·ice de la technologie d'assistance doit lire en utilisant son mode de navigation ou de lecture virtuelle, si disponible.
Parce que les TA avec un mode de lecture par défaut à ce mode pour tous les éléments sauf ceux avec un rôle de composant ou d'application défini, le rôle de document n'est utile que pour les éléments sélectionnables au sein d'un composant ou d'une application qui doivent être lus comme du texte enrichi statique. Ajouter role="document" et tabindex="0" à l'élément contenant le texte dans un composant permet à l'utilisateur·ice de lecteur d'écran d'appuyer sur la touche Tab pour placer la sélection sur l'élément document et lire le texte avec le curseur de lecture du lecteur d'écran.
Les technologies d'assistance doivent revenir au mode document, en interceptant éventuellement les contrôles réaffectés au contexte dynamique du parent, réactivant les évènements d'entrée standard, tels que les évènements de clavier flèche haut ou bas, pour contrôler le curseur de lecture.
Le rôle document n'est pas nécessaire à l'intérieur d'une boîte de dialogue. Une boîte de dialogue est une fenêtre, et non un composant ou une application, donc les technologies d'assistance disposant d'un mode de lecture l'utilisent déjà pour le contenu de la boîte de dialogue.
Interactions au clavier
L'élément doit être rendu sélectionnable afin que les technologies d'assistance puissent passer en mode lecture lorsqu'il reçoit la sélection. L'attribut HTML tabindex="0" le rend sélectionnable et l'ajoute à l'ordre de tabulation, de sorte que l'utilisateur·ice peut y accéder par tabulation et lire le contenu immédiatement.
Fonctionnalités JavaScript requises
Aucune.
Exemples
Un exemple est Gmail et la vue de conversation unique. GMail est une application Web. Lorsqu'il est dans GMail, la plupart des interactions de l'agent utilisateur sont usurpées par l'application. Cependant, lorsque la sélection du clavier est placé sur le titre de départ d'une conversation unique contenant le sujet de la conversation, l'utilisateur·ice de lecteur d'écran peut utiliser les commandes de mode de lecture pour lire les messages, les développer ou les réduire, et les manipuler. Une fois la sélection revenue à la liste des messages, soit en activant le bouton Retour, soit en appuyant sur une combinaison de touches associée, le mode d'interaction directe de l'application est à nouveau invoqué, et l'utilisateur·ice peut se déplacer vers une autre conversation de la liste avec les touches flèche.
Bonnes pratiques
Assurez-vous toujours qu'un élément avec le rôle document est sélectionnable. Définir tabindex="0" est le moyen le plus courant de le faire, mais cela ajoute également l'élément à l'ordre de tabulation, ce qui peut ne pas correspondre à la façon dont les utilisateur·ice·s naviguent dans le reste du composant. Si le composant contenant gère la sélection avec les touches fléchées, par exemple avec un tabindex itinérant, assurez-vous que les utilisateur·ice·s peuvent découvrir comment atteindre le contenu du document et comment revenir au composant par la suite.
Avantages supplémentaires
Le rôle de document est un moyen simple de contrôler indirectement le comportement des technologies d'assistance en déclarant sans ambiguïté qu'il s'agit de contenu que l'utilisateur·ice doit lire avec des commandes standard de lecteur d'écran.
Spécifications
| Spécification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA)> # document> |