ARIA: generic role
The generic
role creates a nameless container element which has no semantic meaning on its own.
Note: The generic
role is the implicit role of generic elements used by user agents. It is included here for completeness of documentation. It should not be used by web authors.
Description
While ARIA is primarily used to express semantics, there are some elements that shouldn't expose a semantic name to assistive technologies. The generic
role indicates an element's role is equivalent to that of the non-semantic <div>
and <span>
elements.
The generic
role is intended for use as the implicit role of generic elements in host languages for use by user agents only; not for use by developers. Instead, to remove implicit accessibility semantics, use presentation
or none
, the <div>
and <span>
elements that have no semantic meaning, or semantic container roles such as group
to semantically group descendants in a named container.
Like an element with role presentation
, an element with role="generic"
can provide a limited number of accessible states and properties for its descendants, such as aria-live
attributes. However, unlike elements with role presentation
, generic
elements are exposed in accessibility APIs so that assistive technologies can gather certain properties such as layout and bounds.
Because the generic role is nameless, the aria-labelledby
and aria-label
attributes are prohibited. Because the role is generic, the aria-roledescription
and aria-brailleroledescription
attributes are also prohibited.
Note: The element with role="generic"
should not have an accessible name or role description.
Associated WAI-ARIA roles, states, and properties
None. If a global ARIA state and property is set, generic
or none
will be ignored, and the implicit role of the element will be used.
Examples
This role is for use by user agents and not by developers. As such, no appropriate example exists.
Specifications
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA) # generic |
See Also
- HTML
<div>
and<span>
elements presentation
roles such asgroup
role