Baseline 2023
Newly available
The role property of the Element interface returns the explicitly set WAI-ARIA role for the element.
All HTML elements have an implicit ARIA role, even if that role is generic. This semantic association allows tools to present and support interaction with the object in a manner that is consistent with user expectations about other objects of that type. The role attribute is used to explicitly set the element's ARIA role, overriding the implicit role. For example, a <ul>, which has an implicit list role, might have role="treegrid" explicitly set. The role property reflects the explicitly set value of the role attributeâin this case treegrid; it does not return the element's implicit list role unless explicitly set.
The full list of defined ARIA roles can be found on the ARIA roles reference page.
ValueA string; the value of the role attribute or null if not explicitly set.
In this example, images with empty or missing alt attributes are given a role of presentation:
const images = document.querySelectorAll("img");
images.forEach((image) => {
if (!image.alt) {
image.role = "presentation";
}
});
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4