aria-orientation attribute indicates whether the element's orientation is horizontal, vertical, or unknown/ambiguous.
It may be important for the user to know the orientation to know how to navigate certain widgets, as orientation impacts the expected behaviors of the left, right, up and down arrows. The
aria-orientation attribute is used to indicate to assistive technology users whether an element's orientation is
Several widgets have default orientations:
Horizontal by default:
Vertical by default:
separator should have
aria-orientation consistent with the separator's orientation.
When nodes in a tree are arranged horizontally instead of its default vertical orientation, or when a tab list is vertical instead of its default horizontal, the down arrow performs as a right arrow normally would, and the up arrow performs as a left arrow normally would. In these instances, assistive technology users need to know the widget's orientation so as to navigate correctly.
Up and down arrows are generally available for normal browser scrolling, even when focus is inside a tree or tab list. Include
aria-orientation to enable alerting users when a widget doesn't have the default, expected orientation and associated navigation.
The element is oriented horizontally.
The element's orientation is unknown/ambiguous.
The element is oriented vertically.
Used in roles:
Inherited into roles:
|Accessible Rich Internet Applications (WAI-ARIA) 1.1
The definition of 'ARIA: aria-orientation Attribute' in that specification.