Element: ariaModal 屬性

Baseline 2023
新推出

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

Element 介面的 ariaModal 屬性反映了 aria-modal 屬性的值,該屬性指示元素在顯示時是否為模態。將 aria-modal 屬性應用於具有 role="dialog" 的元素,可以取代使用 aria-hidden 在背景上以通知輔助技術對話方塊外部內容是惰性的技術。

一個字串,其值可能為以下之一:

"true"

該元素是模態的。

"false"

該元素不是模態的。

示例

在此示例中,ID 為 address-modal 的元素的 aria-modal 屬性設定為“true”,表示這是一個模態對話方塊。使用 ariaModal,我們將值更新為“false”。

html
<div
  role="dialog"
  id="address-modal"
  aria-labelledby="dialog1Title"
  aria-describedby="dialog1Desc"
  aria-modal="true"></div>
js
let el = document.getElementById("address-modal");
console.log(el.ariaModal); // "true"
el.ariaModal = "false";
console.log(el.ariaModal); // "false"

規範

規範
無障礙富網際網路應用程式 (WAI-ARIA)
# dom-ariamixin-ariamodal

瀏覽器相容性

另見