Element: ariaRelevant property
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("DOM")}}{{Non-standard_Header}}
The **ariaRelevant** property of the {{domxref("Element")}} interface reflects the value of the [aria-relevant](/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-relevant) attribute, which indicates what notifications the user agent will trigger when the accessibility tree within a live region is modified. This is used to describe what changes in an aria-live region are relevant and should be announced.
Value
A string containing one or more of the following values, space separated:
"additions"- : Additions of Element Nodes within the live region should be considered relevant.
"removals"- : Deletion of Nodes from the live region should be considered relevant.
"text"- : Changes to the textual content of existing nodes should be considered relevant.
"all"- : Equivalent to
"additions removals text".
Examples
In this example the [aria-relevant](/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-relevant) attribute on the element with an ID of text is set to "all". Using ariaRelevant we update the value to "text".
<div
id="clock"
role="timer"
aria-live="polite"
aria-atomic="true"
aria-relevant="all"></div>let el = document.getElementById("clock");
console.log(el.ariaRelevant); // all
el.ariaRelevant = "text";
console.log(el.ariaRelevant); // textBrowser compatibility
{{Compat}}