ARIA: presentation role
The presentation
role and its synonym none
remove an element's implicit ARIA semantics from being exposed to the accessibility tree.
The content of the element will still be available to assistive technologies; it is only the semantics of the container — and in some instance, required associated descendants — which will no longer expose their mappings to the accessibility API.
Description
While ARIA is primarily used to express semantics, there are some situations where hiding an element's semantics from assistive technologies is helpful. This is done with the presentation
role or its synonym role none
, which declare that an element is being used only for presentation and therefore does not have any accessibility semantics.
Writing <h2 role="presentation">Democracy Dies in Darkness</h2>
removes the heading semantics of the h2 element, making it the equivalent of <div>Democracy Dies in Darkness</div>
. The heading role semantics are removed, but the content itself is still available.
When an element has required descendants, such as the various <table>
, elements and <li>
s children of a <ul>
or <ol>
, the presentation
or none
role on the table or list removes the default semantics of the element on which it was applied and their required descendant elements.
If presentation
or none
is applied to a <table>
element, the descendant <caption>
, <thead>
, <tbody>
, <tfoot>
, <tr>
, <th>
, and <td>
elements inherit the role and are thus not exposed to assistive technologies. But, elements inside of the <th>
and <td>
elements, including nested tables, are exposed to assistive technologies.
html
<ul role="presentation">
<li>
<a href="#">Link 1</a>
</li>
<li>
<a href="#">Link 2</a>
</li>
<li>
<a href="#">Link 3</a>
</li>
</ul>
Because the presentation
role was applied to the <ul>
element, every child <li>
element inherits the presentation
role. This is because ARIA requires the listitem
elements to have a parent list
element. While the <li>
elements, in this case, are not exposed to assistive technologies, descendants of those required elements are exposed. If we had nested a list within one of those <li>
's, they would be visible to assistive technologies. For elements with no required children, any elements nested inside the element with role="presentation"
or role="none"
preserve their semantics. In this case, the <a>
elements contained inside of those <li>
elements are exposed.
The <a>
is a special case. Its role would have been exposed even if it had the presentation
or none
role directly applied to it. Browsers ignore role="presentation"
and role="none"
on focusable elements, including link and inputs, or anything with a tabindex attribute set. Browsers also ignore the inclusion of the role if any of the element contains any global ARIA states and properties, such as aria-describedby
.
Note: The element with role="presentation"
is not part of the accessibility tree and should not have an accessible name. Do not use aria-labelledby
or aria-label
.
Associated WAI-ARIA roles, states, and properties
None. If a global ARIA state and property is set, presentation
or none
will be ignored, and the implicit role of the element will be used.
Examples
html
<hr role="none" />
Specifications
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA) # presentation |
ARIA Authoring Practices # presentation_role |
See Also
aria-hidden
versusrole="presentation/none"
- by Scott O'Hara