É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-autocomplete
aria-checked
aria-disabled
aria-errormessage
aria-expanded
aria-haspopup
aria-hidden
aria-invalid
aria-label
aria-level
aria-modal
aria-multiline
aria-multiselectable
aria-orientation
aria-placeholder
aria-pressed
aria-readonly
aria-required
aria-selected
aria-sort
aria-valuemax
aria-valuemin
aria-valuenow
aria-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-atomic
aria-busy
aria-controls
aria-current
aria-describedby
aria-description
aria-details
aria-disabled
aria-dropeffect
aria-errormessage
aria-flowto
aria-grabbed
aria-haspopup
aria-hidden
aria-invalid
aria-keyshortcuts
aria-label
aria-labelledby
aria-live
aria-owns
aria-relevant
aria-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-activedescendant
identifie l'élément actuellement actif lorsque la sélection est sur un widgetcomposite
, unecombobox
, unetextbox
, ungroup
ou uneapplication
.- ARIA : attribut aria-atomic
Dans les régions dynamiques ARIA, l'attribut global
aria-atomic
indique 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-autocomplete
indique 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 recherchesearchbox
ou 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-braillelabel
dé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-brailleroledescription
dé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-busy
est 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-busy
est 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-checked
indique l'état actuel (« sélectionné » ou non) des cases à cocher, boutons radio et autres widgets.- ARIA : attribut aria-colcount
L'attribut
aria-colcount
dé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-colindex
définit l'indice ou la position de colonne d'un élément par rapport au nombre total de colonnes dans untable
,grid
outreegrid
.- ARIA : attribut aria-colindextext
L'attribut
aria-colindextext
définit une alternative textuelle lisible par humain·e à la valeur numérique dearia-colindex
.- ARIA : attribut aria-colspan
L'attribut
aria-colspan
dé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-controls
identifie 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-current
non 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-describedby
identifie 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-description
définit une valeur textuelle qui décrit ou annote l'élément courant.- ARIA : attribut aria-details
L'attribut global
aria-details
identifie l'élément (ou les éléments) qui fournissent des informations supplémentaires liées à l'objet.- ARIA : attribut aria-disabled
L'état
aria-disabled
indique que l'élément est perceptible mais désactivé, donc non modifiable ni opérable.- ARIA : attribut aria-required
L'attribut
aria-required
indique qu'une saisie de l'utilisatrice ou de l'utilisateur est requise pour cet élément avant qu'un formulaire puisse être envoyé.