Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

ARIA : attribut aria-orientation

L'attribut aria-orientation indique si l'orientation d'un élément est horizontale, verticale ou inconnue/ambiguë.

Description

Il peut être important pour l'utilisateur·ice de connaître l'orientation afin de savoir comment naviguer dans certains widgets, car l'orientation influence le comportement attendu des flèches gauche, droite, haut et bas. L'attribut aria-orientation est utilisé pour indiquer aux technologies d'assistance si l'orientation d'un élément est horizontal, vertical ou undefined.

Plusieurs widgets ont des orientations par défaut :

Horizontal par défaut :

Vertical par défaut :

Chaque separator doit avoir une aria-orientation cohérente avec l'orientation du séparateur.

Lorsque les nœuds d'un arbre sont disposés horizontalement au lieu de la disposition verticale par défaut, ou lorsqu'une liste d'onglets est verticale au lieu de l'horizontale par défaut, la flèche bas se comporte comme le ferait normalement la flèche droite, et la flèche haut se comporte comme la flèche gauche. Dans ces cas, les utilisateur·ice·s de technologies d'assistance doivent connaître l'orientation du widget afin de naviguer correctement.

Les flèches haut et bas sont généralement disponibles pour le défilement normal du navigateur, même lorsque le focus se trouve à l'intérieur d'un arbre ou d'une liste d'onglets. Incluez aria-orientation pour alerter les utilisateur·ice·s lorsqu'un widget n'a pas l'orientation par défaut attendue et la navigation associée.

Rappelez-vous toujours que ARIA ne modifie que la façon dont les technologies d'assistance présentent le contenu à vos utilisateur·ice·s ; modifier le comportement des touches fléchées nécessite JavaScript.

Valeurs

horizontal

L'élément est orienté horizontalement.

undefined (par défaut)

L'orientation de l'élément est inconnue/ambiguë.

vertical

L'élément est orienté verticalement.

Interfaces associées

Element.ariaOrientation

La propriété ariaOrientationariaOrientation faisant partie de l'interface Element, reflète la valeur de l'attribut aria-orientation.

ElementInternals.ariaOrientation

La propriété ariaOrientation, faisant partie de l'interface ElementInternals, reflète la valeur de l'attribut aria-orientation.

Rôles associés

Utilisé dans les rôles :

Hérité par les rôles :

Spécifications

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# aria-orientation

Voir aussi