Web Components
The ariaBrailleRoleDescription property of the ElementInternals interface reflects the value of the aria-brailleroledescription attribute, which defines the ARIA braille role description of the element.
This property may be used to provide an abbreviated version of the aria-roledescription value.
It should only be used if aria-roledescription is present and in the rare case where it is too verbose for braille.
The aria-brailleroledescription contains additional information about when the property should be set.
Value
A string that is intended to be converted into braille.
Examples
Assuming we have a custom slide element:
class CustomSlide extends HTMLElement {
constructor() {
super();
this._internals = this.attachInternals();
this._internals.role = "slide";
}
// …
}
customElements.define("custom-slide", CustomSlide);
<custom-slide></custom-slide>
<pre id="log"></pre>
const logElement = document.querySelector("#log");
function log(value) {
logElement.textContent += `${value}\n`;
}
We can retrieve and set the value of the custom element's aria-brailleroledescription value:
const customEl = document.querySelector("custom-slide");
log(customEl._internals.ariaBrailleRoleDescription);
customEl._internals.ariaBrailleRoleDescription = "sd";
log(customEl._internals.ariaBrailleRoleDescription);
Result
examples
Specifications
Browser compatibility
See also
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
