Element: ariaHasPopup-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 ariaHasPopup-Eigenschaft des Element-Interfaces spiegelt den Wert des aria-haspopup-Attributs wider, das die Verfügbarkeit und den Typ eines interaktiven Popup-Elements, wie Menü oder Dialog, angibt, das durch ein Element ausgelöst werden kann.

Wert

Ein String mit einem der folgenden Werte:

"false": Das Element hat kein Popup.
"true": Das Element hat ein Popup, das ein Menü ist.
"menu": Das Element hat ein Popup, das ein Menü ist.
"listbox": Das Element hat ein Popup, das eine Listbox ist.
"tree": Das Element hat ein Popup, das ein Baum ist.
"grid": Das Element hat ein Popup, das ein Raster ist.
"dialog": Das Element hat ein Popup, das ein Dialog ist.

Warnung: Beachten Sie, dass die Unterstützung für die verschiedenen aria-haspopup-Werte je nach Element, dem das Attribut zugewiesen ist, variieren kann. Stellen Sie sicher, dass Sie aria-haspopup in Übereinstimmung mit der ARIA-Spezifikation verwenden und dass es wie erwartet funktioniert, wenn Sie es mit den erforderlichen Browsern und unterstützenden Technologien testen.

Beispiele

In diesem Beispiel wird das aria-haspopup-Attribut des Elements mit der ID animal auf "true" gesetzt. Mit ariaHasPopup aktualisieren wir den Wert auf "listbox", was der erwartete Wert für eine Kombinationsfeld ist, das ein listbox-Popup aufruft.

html

<div class="animals-combobox">
  <label for="animal">Animal</label>
  <input
    id="animal"
    type="text"
    role="combobox"
    aria-autocomplete="list"
    aria-controls="animals-listbox"
    aria-activedescendant=""
    aria-expanded="false"
    aria-haspopup="true" />
  <ul id="animals-listbox" role="listbox" aria-label="Animals">
    <li id="animal-cat" role="option">Cat</li>
    <li id="animal-dog" role="option">Dog</li>
  </ul>
</div>

let el = document.getElementById("animal");
console.log(el.ariaHasPopup); // true
el.ariaHasPopup = "listbox";
console.log(el.ariaHasPopup); // listbox

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser