ARIA: generic role
Thegeneric role creates a nameless container element which has no semantic meaning on its own.
Note:Thegeneric 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.
In this article
Description
While ARIA is primarily used to express semantics, there are some elements that shouldn't expose a semantic name to assistive technologies. Thegeneric role indicates an element's role is equivalent to that of the non-semantic<div> and<span> elements.
Thegeneric 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, usepresentation ornone, the<div> and<span> elements that have no semantic meaning, or semantic container roles such asgroup to semantically group descendants in a named container.
Like an element with rolepresentation, an element withrole="generic" can provide a limited number of accessible states and properties for its descendants, such asaria-live attributes. However, unlike elements with rolepresentation,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, thearia-labelledby andaria-label attributes are prohibited. Because the role is generic, thearia-roledescription andaria-brailleroledescription attributes are also prohibited.
Note:The element withrole="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 ornone 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 presentationroles such asgrouprole