ARIA : rôle graphics-document
Le rôle graphics-document identifie un type de document dans lequel l'apparence visuelle ou la disposition du contenu transmet un sens.
Note :
Le rôle graphics-document est défini dans la spécification du Module graphique WAI-ARIA (angl.).
Il ne fait pas partie de la spécification principale de WAI-ARIA (angl.).
Description
Le rôle graphics-document s'applique à l'élément racine d'un graphique dont la représentation visuelle, généralement en deux dimensions, a une signification sémantique. Les utilisateur·ice·s sont censés principalement parcourir ce contenu plutôt que de contrôler une application.
C'est généralement utilisé pour des graphiques structurés et sémantiquement significatifs tels que des organigrammes, des cartes, des diagrammes et des dessins techniques.
Le rôle graphics-document se distingue des rôles similaires de la manière suivante :
- Contrairement à un élément ayant le rôle
img, un élément avec le rôlegraphics-documentpeut inclure des éléments enfants ayant une signification sémantique, tels que des liens et d'autres composants interactifs. - Comparé à d'autres types de
document, ungraphics-documentse distingue par l'importance sémantique de sa représentation visuelle. - Contrairement à un
graphics-object, ungraphics-documentest autonome : sa signification ne dépend pas du contenu environnant, et il fournit le contexte pour interpréter ses enfants.
Un graphics-document peut contenir un autre graphics-document, comme un diagramme à barres intégré dans une carte. Chaque document imbriqué fournit son propre contexte pour la navigation.
Lorsqu'on traite un graphique unique et volumineux avec des régions distinctes pouvant être réorganisées sans en modifier le sens, chaque région doit être séparée en tant que graphics-document autonome. Vous pouvez regrouper ces régions en utilisant le rôle figure.
Rôles, états et propriétés WAI-ARIA associés
aria-labelledbyouaria-label-
Un
graphics-documentdoit avoir un nom accessible. Utilisezaria-labelledbysi une étiquette visible est présente, sinon utilisezaria-label. Pour SVG, un élément<title>peut également fournir le nom.
Exemples
Cet organigramme utilise des éléments HTML disposés avec CSS. Le rôle graphics-document identifie le diagramme comme un document graphique, car l'agencement de ses nœuds et flèches transmet le flux d'authentification. L'attribut aria-label fournit son nom accessible. Chaque flèche a un rôle graphics-symbol et une étiquette décrivant la connexion, de sorte que le flux peut également être compris sans voir la disposition.
Si ce graphique est implémenté à l'aide de <svg> à la place, aucune déclaration de role n'est nécessaire, car SVG-AAM définit graphics-document comme rôle par défaut.
<div
class="flowchart"
role="graphics-document"
aria-label="Organigramme du flux d'authentification utilisateur">
<div
class="node start"
role="graphics-object"
aria-label="Connexion utilisateur : Saisir les identifiants">
Connexion utilisateur
</div>
<div
class="arrow next"
role="graphics-symbol"
aria-label="Après avoir saisi les identifiants, vérifier s'ils sont valides"></div>
<div
class="node decision"
role="graphics-object"
aria-label="Valide ? : Les identifiants sont-ils valides ?">
<span>Valide ?</span>
</div>
<div
class="arrow yes"
role="graphics-symbol"
aria-label="Oui : Si les identifiants sont valides, accorder l'accès">
<span>Oui</span>
</div>
<div class="node grant" role="graphics-object">Accorder l'accès</div>
<div
class="arrow no"
role="graphics-symbol"
aria-label="Non : Si les identifiants sont invalides, refuser l'accès">
<span>Non</span>
</div>
<div class="node deny" role="graphics-object">Refuser l'accès</div>
</div>
.flowchart {
position: relative;
width: 500px;
height: 300px;
color: black;
background: white;
font-size: large;
}
.node {
position: absolute;
display: grid;
place-items: center;
box-sizing: border-box;
width: 100px;
height: 60px;
border: 1px solid black;
}
.start {
left: 200px;
top: 30px;
background: #3eca39;
}
.decision {
left: 200px;
top: 130px;
border: none;
background: black;
clip-path: polygon(50% 0, 100% 50%, 50% 100%, 0 50%);
}
.decision::before {
content: "";
position: absolute;
inset: 1px 2px;
background: #cac539;
clip-path: inherit;
}
.decision span {
position: relative;
}
.grant {
left: 290px;
top: 220px;
background: #86ca39;
}
.deny {
left: 120px;
top: 220px;
color: white;
background: #ca393e;
}
.arrow {
position: absolute;
height: 1.6px;
background: black;
transform-origin: left center;
}
.arrow::after {
content: "";
position: absolute;
right: 0;
top: -2.2px;
border-top: 3px solid transparent;
border-bottom: 3px solid transparent;
border-left: 10px solid black;
}
.next {
left: 250px;
top: 90px;
width: 40px;
transform: rotate(90deg);
}
.yes {
left: 280px;
top: 172px;
width: 77px;
transform: rotate(39deg);
}
.no {
left: 220px;
top: 172px;
width: 69px;
transform: rotate(136deg);
}
.arrow span {
position: absolute;
left: 25px;
}
.yes span {
top: -22px;
transform: rotate(-39deg);
}
.no span {
top: 8px;
transform: rotate(-136deg);
}
Bonnes pratiques
Ne pas ajouter de rôle graphics-document explicite lorsque l'élément fournit déjà ce rôle par sa sémantique native, comme le fait <svg>.
Pour les graphiques SVG décoratifs, utilisez aria-hidden="true". Pour les graphiques sans structure interne significative, utilisez le rôle img avec un nom accessible. Pour les images HTML, utilisez l'élément natif <img> avec un attribut alt.
Spécifications
| Spécification |
|---|
| Unknown specification> # graphics-document> |