01
Chercher le token exact
button, role=button et aria-expanded sont acceptés. Le filtre distingue rôles et attributs sans requête vers un service externe.
Référence pour développeurs
rôles ARIAet attributs à consulter
Recherchez un rôle ou un attribut aria-* et lisez son exemple, ses conditions d’interaction et sa source normative.
rôles ARIA
Résultats
button
Rôlebutton déclenche une action ; l’élément HTML natif fournit déjà focus et clavier.
Clavier: Le HTML natif prend en charge les touches de base ; un rôle personnalisé exige du code.
Attention: Évitez de répéter un rôle lorsque l’élément natif a déjà même sens et même comportement.
Exigences clés: Aucune
Exemple HTML
<button type="button">Save</button>Essayer un contrôle
Activé 0 fois
La recherche reste sur cette page ; les sources externes ne s’ouvrent que sur demande.
Catégorie
1 sur 16 entrées
WAI-ARIA 1.2 · 6 juin 2023Fiches vérifiées le 23 septembre 2026
Avant d’ajouter un rôle à un composant, vérifiez si le HTML natif suffit. Les rôles ARIA expriment une sémantique ; ils ne donnent pas à un div les comportements clavier d’un vrai bouton.
Cette sélection de rôles ARIA rassemble aussi les propriétés et états utiles, avec des extraits à copier. Les schémas APG restent indispensables pour un onglet, une boîte de dialogue ou une liste déroulante personnalisée.
Pourquoi consulter les rôles ARIA ici
L’exemple, le comportement requis et le texte source restent liés.
Comparer avec le HTML natif
Les fiches button et checkbox commencent par les éléments HTML. Même avec des rôles ARIA, un div ne devient ni focusable ni activable par Entrée et Espace sans code supplémentaire.
Relier état et contenu
L’exemple aria-expanded associe le bouton à son panneau. Quand on applique des rôles ARIA ou des états, la valeur annoncée doit évoluer avec la partie réellement affichée.
Trois vérifications avant intégration
02
Lire les conditions avant de copier
Une fiche de rôles ARIA montre la sémantique de départ. Pour tab, dialog ou combobox, lisez le schéma APG et prévoyez le focus et le clavier.
03
Contrôler la version puis essayer
Chaque fiche renvoie à la définition figée de WAI-ARIA 1.2. Testez ensuite votre vrai composant au clavier et avec un lecteur d’écran.
La définition au contact du code
Deux familles dans une recherche
Huit rôles et huit attributs ou états aria-* figurent dans l’index. Une absence de résultat ne signifie pas qu’un terme est interdit par la norme.
Exemple relié à la norme
Chaque fiche fournit un fragment HTML et son ancre WAI-ARIA 1.2 ; les composants complexes renvoient aussi aux pratiques APG.
Les états ne pilotent pas l’interface
aria-expanded annonce un état, mais n’ouvre aucun panneau à lui seul. Le code doit modifier à la fois l’affichage et la valeur annoncée.
Ce que la fiche ne peut pas conclure
- Sélection de seize entrées
- Cette référence des rôles ARIA et attributs ne reprend pas toute la norme. Pour un token absent, consultez l’index W3C complet.
- Extrait non fonctionnel à lui seul
- Copier tab, dialog ou un checkbox personnalisé ne crée pas la navigation aux flèches, la gestion du focus ou la mise à jour des états.
- Aucun verdict WCAG
- La page ne parcourt pas votre DOM et ne teste pas votre lecteur d’écran. La mesure du contraste se fait dans l’outil dédié ; l’usage réel demande des essais humains.
Questions sur les rôles ARIA
Quand utiliser un rôle ARIA plutôt qu'un élément HTML natif ?
Si un élément HTML offre déjà le sens et le comportement voulus, préférez-le. Les rôles ARIA servent aux composants que le HTML natif ne peut pas décrire seul, avec une interaction à implémenter.
Le rôle button ajoute-t-il la prise en charge du clavier ?
Non. role=button change l’annonce faite aux technologies d’assistance, pas le focus ni les touches Entrée et Espace. Un élément button natif évite souvent ce travail.
Quelle différence entre aria-label et aria-labelledby ?
aria-label contient directement le texte du nom. aria-labelledby renvoie aux ID d’éléments dont le texte fournit ce nom. Privilégiez une étiquette visible ou un label HTML quand ils conviennent.
Quels attributs sont requis pour un rôle ARIA ?
Cela dépend du rôle. La fiche affiche les relations et états essentiels, et la définition liée de WAI-ARIA 1.2 contient les exigences normatives complètes.
Une référence ARIA garantit-elle la conformité WCAG ?
Non. Une liste de rôles ARIA aide à choisir des termes, mais la conformité dépend du contenu réel, du focus, du clavier et des tests avec des technologies d’assistance.
Une entrée manque ou comporte une erreur ?
Consulter les rôles ARIA maintenant
Choisissez un token, vérifiez l’alternative HTML et ouvrez la définition W3C avant de l’intégrer.