元素：ariaRelevant 屬性

Baseline 2023

新推出

自 ⁨2023 年 10 月⁩ 以來，此功能已在最新裝置和瀏覽器版本中得到支援。此功能可能無法在舊裝置或瀏覽器上執行。

非標準：此特性未標準化。我們不建議在生產環境中使用非標準特性，因為它們瀏覽器支援有限，並且可能會更改或被移除。但是，在沒有標準選項的特定情況下，它們可以是合適的替代方案。

Element 介面的 ariaRelevant 屬性反映了 aria-relevant 屬性的值，該屬性指示當 live region 內的可訪問性樹被修改時，使用者代理將觸發哪些通知。這用於描述 aria-live region 中哪些更改是相關的，應該被播報。

值

一個字串，包含以下一個或多個值，以空格分隔

在此示例中，ID 為 text 的元素的 aria-relevant 屬性設定為 "all"。使用 ariaRelevant，我們將該值更新為 "text"。

html

<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); // text

此頁面最後修改於 2025年3月6日，由 MDN 貢獻者修改。