États et propriétés ARIA (attributs)
Cette page constitue un index des pages de référence couvrant l'ensemble des attributs WAI-ARIA sur MDN.
Les attributs ARIA permettent de modifier les états et les propriétés d'un élément dans l'arbre d'accessibilité.
Note : ARIA modifie uniquement l'arbre d'accessibilité, modifiant ainsi la façon dont les outils d'assistance présentent le contenu aux personnes qui les utilisent. ARIA ne modifie en rien les fonctionnalités ou le comportement d'un élément. Lorsqu'on utilise des éléments HTML en dehors de leur sémantique et de leurs fonctionnalités prévues, il faudra utiliser JavaScript pour gérer le comportement, le focus et les états ARIA.
Types d'attribut ARIA
Il existe 4 catégories d'états et de propriétés ARIA :
Attributs de widgets
aria-autocompletearia-checkedaria-disabledaria-errormessagearia-expandedaria-haspopuparia-hiddenaria-invalidaria-labelaria-levelaria-modalaria-multilinearia-multiselectablearia-orientationaria-placeholderaria-pressedaria-readonlyaria-requiredaria-selectedaria-sortaria-valuemaxaria-valueminaria-valuenowaria-valuetext
Attributs de régions dynamiques
Attributs de glisser-déposer
Attributs de relation
Attributs ARIA universels
Certains états et propriétés s'appliquent à l'ensemble des éléments HTML, qu'un rôle AIRA soit appliqué ou non. Ils sont définis comme des attributs « universels ». Les états et propriétés universels sont pris en charge par tous les rôles et tous les éléments de balisage de base.
La plupart des attributs listés avant sont universels, ce qui signifie qu'on peut les inclure sur n'importe quel élément, à moins qu'ils soient explicitement interdits :
aria-atomicaria-busyaria-controlsaria-currentaria-describedbyaria-descriptionaria-detailsaria-disabledaria-dropeffectaria-errormessagearia-flowtoaria-grabbedaria-haspopuparia-hiddenaria-invalidaria-keyshortcutsaria-labelaria-labelledbyaria-livearia-ownsaria-relevantaria-roledescription
Tous les attributs de cette liste sont universels et seules les propriétés aria-label et aria-labelledby ne sont pas autorisées sur les éléments dont le rôle vaut presentation) ou le rôle synonyme none).
États et propriétés définis sur MDN
Les pages suivantes sont les pages de référence qui couvrent les états et propriétés WAI-ARIA sur MDN.
- ARIA : attribut aria-activedescendant
L'attribut
aria-activedescendantidentifie l'élément actuellement actif lorsque la sélection est sur un widgetcomposite, unecombobox, unetextbox, ungroupou uneapplication.- ARIA : attribut aria-atomic
Dans les régions dynamiques ARIA, l'attribut global
aria-atomicindique si les technologies d'assistance, comme les lecteurs d'écran, présenteront l'ensemble ou seulement une partie de la région modifiée, selon les notifications de changement définies par l'attributaria-relevant.- ARIA : attribut aria-autocomplete
L'attribut
aria-autocompleteindique si la saisie de texte peut déclencher l'affichage d'une ou plusieurs suggestions de la valeur souhaitée par l'utilisateur·ice pour une boîte combinéecombobox, une zone de recherchesearchboxou une zone de saisietextbox, et précise comment ces suggestions seront présentées si elles existent.- ARIA : attribut aria-braillelabel
La propriété globale
aria-braillelabeldéfinit une valeur de chaîne de caractères qui étiquette l'élément actuel, qui est destiné à être converti en braille.- ARIA : attribut aria-brailleroledescription
L'attribut global
aria-brailleroledescriptiondéfinit une description abrégée, lisible par un·e humain·e et localisée par l'auteur·ice, du rôle d'un élément, destinée à être convertie en braille.- ARIA : attribut aria-busy
L'attribut
aria-busyest un état ARIA global qui indique si un élément est en cours de modification. Il aide les technologies d'assistance à comprendre que les changements apportés au contenu ne sont pas encore terminés, et qu'elles doivent attendre avant d'informer l'utilisateur·ice de la mise à jour. Siaria-busyest couramment utilisé dans les régions ARIA dynamiques pour retarder les annonces jusqu'à la fin des mises à jour, il peut aussi être utilisé en dehors de ces régions : par exemple, dans des widgets ou des fils d'actualités, pour signaler des modifications en cours ou un chargement.- ARIA : attribut aria-checked
L'attribut
aria-checkedindique l'état actuel (« sélectionné » ou non) des cases à cocher, boutons radio et autres widgets.- ARIA : attribut aria-colcount
L'attribut
aria-colcountdéfinit le nombre total de colonnes dans un tableau (table), une grille (grid) ou une grille arborescente (treegrid) lorsque toutes les colonnes ne sont pas présentes dans le DOM.- ARIA : attribut aria-colindex
L'attribut
aria-colindexdéfinit l'indice ou la position de colonne d'un élément par rapport au nombre total de colonnes dans untable,gridoutreegrid.- ARIA : attribut aria-colindextext
L'attribut
aria-colindextextdéfinit une alternative textuelle lisible par humain·e à la valeur numérique dearia-colindex.- ARIA : attribut aria-colspan
L'attribut
aria-colspandéfinit le nombre de colonnes occupées par une cellule ou une cellule de grille (gridcell) dans un tableau (table), une grille (grid) ou une grille arborescente (treegrid).- ARIA : attribut aria-controls
L'attribut global
aria-controlsidentifie l'élément (ou les éléments) dont le contenu ou la présence est contrôlé·e par l'élément sur lequel cet attribut est défini.- ARIA : attribut aria-current
L'attribut d'état
aria-currentnon nul sur un élément indique que cet élément représente l'élément courant au sein d'un conteneur ou d'un ensemble d'éléments liés.- ARIA : attribut aria-describedby
L'attribut global
aria-describedbyidentifie l'élément (ou les éléments) qui décrivent l'élément sur lequel l'attribut est défini.- ARIA : attribut aria-description
L'attribut global
aria-descriptiondéfinit une valeur textuelle qui décrit ou annote l'élément courant.- ARIA : attribut aria-details
L'attribut global
aria-detailsidentifie l'élément (ou les éléments) qui fournissent des informations supplémentaires liées à l'objet.- ARIA : attribut aria-disabled
L'état
aria-disabledindique que l'élément est perceptible mais désactivé, donc non modifiable ni utilisable.- ARIA : attribut aria-dropeffect
L'attribut global
aria-dropeffectindique quelles fonctions peuvent être réalisées lorsqu'un objet déplacé est relâché sur la cible de dépôt.- ARIA : attribut aria-errormessage
L'attribut
aria-errormessagesur un objet identifie le ou les éléments qui fournissent un message d'erreur pour cet objet.- ARIA : attribut aria-expanded
L'attribut
aria-expandedest défini sur un élément pour indiquer si un contrôle est développé ou réduit, et si les éléments contrôlés sont affichés ou masqués.- ARIA : attribut aria-flowto
L'attribut global
aria-flowtoidentifie le ou les éléments suivants dans un ordre de lecture alternatif du contenu. Cela permet aux technologies d'assistance de remplacer, à la demande de l'utilisateur·ice, l'ordre de lecture par défaut du document (l'ordre source).- ARIA : attribut aria-grabbed
L'attribut
aria-grabbedindique l'état de « saisi » d'un élément lors d'une opération de glisser-déposer.- ARIA : attribut aria-haspopup
L'attribut
aria-haspopupindique la disponibilité et le type d'élément contextuel interactif pouvant être déclenché par l'élément sur lequel l'attribut est défini.L'attribut
aria-hiddenindique un état d'élément déterminant s'il est exposé à une API d'accessibilité.- ARIA : attribut aria-invalid
L'attribut
aria-invalidindique l'état de la valeur saisie comme ne correspondant pas au format attendu par l'application.- ARIA : attribut aria-keyshortcuts
L'attribut global
aria-keyshortcutsindique les raccourcis clavier qu'un·e auteur·ice a mis en place pour activer ou donner la sélection à un élément.- ARIA : attribut aria-label
L'attribut
aria-labeldéfinit une chaîne de caractères qui peut servir à nommer un élément, tant que le rôle de l'élément n'interdit pas la nomination.- ARIA : attribut aria-labelledby
L'attribut
aria-labelledbyidentifie l'élément (ou les éléments) qui servent de libellé à l'élément sur lequel il est appliqué.- ARIA : attribut aria-level
L'attribut
aria-leveldéfinit le niveau hiérarchique d'un élément au sein d'une structure.- ARIA : attribut aria-live
L'attribut global
aria-liveindique qu'un élément sera mis à jour et décrit le type de mises à jour que les agents utilisateurs, les technologies d'assistance et les utilisateur·ice·s peuvent attendre de la région dynamique.- ARIA : attribut aria-modal
L'attribut
aria-modalindique si un élément est modal lorsqu'il est affiché.- ARIA : attribut aria-multiline
L'attribut
aria-multilineindique si unetextboxaccepte plusieurs lignes de saisie ou seulement une.- ARIA : attribut aria-multiselectable
L'attribut
aria-multiselectableindique que l'utilisateur·ice peut sélectionner plusieurs éléments parmi les descendants sélectionnables.- ARIA : attribut aria-orientation
L'attribut
aria-orientationindique si l'orientation d'un élément est horizontale, verticale ou inconnue/ambiguë.- ARIA : attribut aria-owns
L'attribut
aria-ownsidentifie un ou plusieurs éléments afin de définir une relation visuelle, fonctionnelle ou contextuelle entre un parent et ses éléments enfants lorsque la hiérarchie DOM ne peut pas être utilisée pour représenter cette relation.- ARIA : attribut aria-placeholder
L'attribut
aria-placeholderdéfinit une courte indication (un mot ou une phrase brève) destinée à aider l'utilisateur·ice lors de la saisie de données quand un contrôle de formulaire n'a pas de valeur. L'indication peut être une valeur d'exemple ou une brève description du format attendu.- ARIA : attribut aria-posinset
L'attribut
aria-posinsetdéfinit le numéro ou la position d'un élément dans l'ensemble courant des éléments de liste (listitem) ou d'arbre (treeitem) lorsque tous les éléments ne sont pas présents dans le DOM.- ARIA : attribut aria-pressed
L'attribut
aria-pressedindique l'état « enfoncé » actuel d'un bouton à bascule.- ARIA : attribut aria-readonly
L'attribut
aria-readonlyindique que l'élément n'est pas modifiable, mais reste utilisable.- ARIA : attribut aria-relevant
Utilisé dans les régions ARIA dynamiques, l'attribut global
aria-relevantindique quelles notifications l'agent utilisateur va déclencher lorsque l'arbre d'accessibilité d'une région dynamique est modifié.- ARIA : attribut aria-required
L'attribut
aria-requiredindique qu'une saisie de l'utilisatrice ou de l'utilisateur est requise pour cet élément avant qu'un formulaire puisse être envoyé.- ARIA : attribut aria-roledescription
L'attribut
aria-roledescriptiondéfinit une description du rôle d'un élément, lisible par l'humain et localisée par l'auteur·ice.- ARIA : attribut aria-rowcount
L'attribut
aria-rowcountdéfinit le nombre total de lignes dans un tableau, une grille ou une arborescence de grille.- ARIA : attribut aria-rowindex
L'attribut
aria-rowindexdéfinit la position d'un élément par rapport au nombre total de lignes dans un tableau, une grille ou une arborescence de grille.- ARIA : attribut aria-rowindextext
L'attribut
aria-rowindextextdéfinit une alternative textuelle lisible par l'humain pouraria-rowindex.- ARIA : attribut aria-rowspan
L'attribut
aria-rowspandéfinit le nombre de lignes sur lesquelles une cellule ou une cellule de grille s'étend dans un tableau, une grille ou une arborescence de grille.- ARIA : attribut aria-selected
L'attribut
aria-selectedindique l'état « sélectionné » actuel de divers widgets.- ARIA : attribut aria-setsize
L'attribut
aria-setsizedéfinit le nombre d'éléments dans l'ensemble courant d'éléments de liste (listitem) ou d'arbre (treeitem) lorsque tous les éléments de l'ensemble ne sont pas présents dans le DOM.- ARIA : attribut aria-sort
L'attribut
aria-sortindique si les éléments d'un tableau ou d'une grille sont triés par ordre croissant ou décroissant.- ARIA : attribut aria-valuemax
L'attribut
aria-valuemaxdéfinit la valeur maximale autorisée pour un composant de type plage.- ARIA : attribut aria-valuemin
L'attribut
aria-valuemindéfinit la valeur minimale autorisée pour un composant de type plage.- ARIA : attribut aria-valuenow
L'attribut
aria-valuenowdéfinit la valeur actuelle pour un composant de type plage (range).- ARIA : attribut aria-valuetext
L'attribut
aria-valuetextdéfinit l'alternative textuelle compréhensible par l'humain dearia-valuenowpour un composant de type plage.