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

浏览器兼容性

另见