ARIA : rôle log

Description

Un journal (log en anglais) est un type de zone en direct où de nouvelles informations sont ajoutées dans un ordre significatif et où les anciennes informations peuvent disparaître. Des exemples incluent les journaux de discussion, l'historique des messages, les journaux de jeu ou un journal d'erreurs. Contrairement à d'autres zones en direct, dans ce rôle, il existe une relation entre l'arrivée de nouveaux éléments dans le journal et l'ordre de lecture. Le journal contient une séquence significative et de nouvelles informations ne sont ajoutées qu'à la fin du journal, et non à des points arbitraires.

Contrairement à d'autres types de zones en direct, un journal est ordonné de manière séquentielle et de nouvelles informations ne sont ajoutées qu'à la fin du journal. Lorsque ce rôle est ajouté à un élément, le navigateur enverra un événement de journal accessible aux produits de technologie d'assistance qui pourront alors notifier l'utilisateur·ice à ce sujet.

Par défaut, les mises à jour ne contiennent que les modifications apportées à la zone en direct et celles-ci sont annoncées lorsque l'utilisateur·ice est inactif·ve. Les éléments ayant le rôle log ont une valeur implicite aria-live de polite. Lorsque l'utilisateur·ice doit entendre l'ensemble de la zone en direct lors d'un changement, aria-atomic="true" doit être défini. Pour que les annonces soient faites dès que possible et où l'utilisateur·ice peut être interrompu·e, aria-live="assertive" peut être défini pour des mises à jour plus agressives.

Propriétés, états et rôles WAI-ARIA associés

aria-atomic

Définit si les technologies d'assistance doivent présenter l'ensemble ou seulement une partie de la région modifiée. Les éléments ayant le rôle log ont une valeur implicite aria-atomic de false.

aria-live

Définit quand la technologie d'assistance doit informer l'utilisateur·ice des mises à jour du contenu. Les éléments ayant le rôle log ont une valeur implicite aria-live de polite, ce qui signifie que les lecteurs d'écran annonceront les changements à l'intérieur du journal lorsque l'utilisateur·ice est inactif·ve.

aria-label et aria-labelledby

Le rôle log doit avoir un nom accessible. Utilisez aria-labelledby si un label visible est présent, sinon utilisez aria-label.

Bonnes pratiques

Avec une zone qui a du texte défilant, comme un téléscripteur boursier, le rôle marquee doit être utilisé à la place.

Spécifications

Voir aussi

• ARIA : rôle alert
• ARIA : rôle marquee
• ARIA : rôle status
• ARIA : rôle timer
• Les zones ARIA en direct