元素：ariaModal 属性

基线 2023

新可用

自 2023 年 10 月起，此功能可在最新的设备和浏览器版本中使用。此功能可能无法在较旧的设备或浏览器中使用。

ariaModal 是 Element 接口的一个属性，它反映了 aria-modal 属性的值，该属性指示元素在显示时是否为模态。将 aria-modal 属性应用于具有 role="dialog" 的元素，取代了在背景上使用 aria-hidden 的方法来告知辅助技术对话框外部的内容处于非活动状态。

值

一个包含以下值之一的字符串

"true"

该元素为模态。

"false"

该元素不是模态。

示例

在这个例子中，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

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅