Element: ariaModal-Eigenschaft

Baseline 2023

Newly available

Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die ariaModal-Eigenschaft der Element-Schnittstelle spiegelt den Wert des aria-modal-Attributs wider, das angibt, ob ein Element modale Eigenschaften hat, wenn es angezeigt wird. Die Anwendung der aria-modal-Eigenschaft auf ein Element mit role="dialog" ersetzt die Technik der Verwendung von aria-hidden im Hintergrund, um unterstützenden Technologien mitzuteilen, dass Inhalte außerhalb eines Dialogs inaktiv sind.

Wert

Ein String mit einem der folgenden Werte:

"true"

Das Element ist modal.

"false"

Das Element ist nicht modal.

Beispiele

In diesem Beispiel wird das aria-modal-Attribut des Elements mit der ID address-modal auf "true" gesetzt, was anzeigt, dass es sich um einen modalen Dialog handelt. Mit ariaModal wird der Wert auf "false" aktualisiert.

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"

Spezifikationen

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-ariamodal

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch