aria-haspopup

Das aria-haspopup-Attribut zeigt die Verfügbarkeit und den Typ eines interaktiven Popups an, das durch das Element ausgelöst werden kann, auf dem das Attribut gesetzt ist.

Beschreibung

In ARIA werden interaktive Menüs, Listboxen, Bäume, Raster und Dialoge, die über anderen Inhalten erscheinen, wenn sie ausgelöst werden, als "Popups" betrachtet. Diese Popups werden durch eines oder mehrere interaktive Elemente auf der Seite ausgelöst. Die Verfügbarkeit und der Typ des Popups, das das interaktive Element auslösen wird, sollten mit dem aria-haspopup-Zustand identifiziert werden.

Das Vorhandensein von aria-haspopup mit einem der sechs aufgelisteten Werte - menu, listbox, tree, grid, dialog oder true - zeigt an, dass das Element ein Popup auslösen kann und welche Art von Popup angezeigt wird. Das auftauchende Element muss die angegebene Rolle haben. Der Wert true entspricht menu. Jeder andere Wert, einschließlich eines leeren Strings oder einer anderen Rolle, wird so behandelt, als wäre false gesetzt.

Ein Tooltip wird in diesem Kontext nicht als Popup angesehen, da es nicht interaktiv ist.

Hinweis: Stellen Sie sicher, dass die Rolle des Elements, das als Container für den Popup-Inhalt dient, ein menu, listbox, tree, grid oder dialog ist und dass der Wert von aria-haspopup mit der Rolle des Popup-Containers übereinstimmt.

Der aria-haspopup-Zustand informiert Benutzer von unterstützenden Technologien darüber, dass ein Popup vorhanden ist und um welche Art von Popup es sich handelt, bietet jedoch keine Interaktivität. Damit das Popup über die Tastatur zugänglich ist, stellen Sie sicher, dass das Element mit aria-haspopup fokussierbar ist und das Popup auslösen kann, dass es einen Tastaturmechanismus zum Öffnen des Popups gibt, und dass das Popup-Element den Fokus aller seiner Nachkommen verwaltet.

Hinweis: ARIA ermöglicht keine zugängliche Funktionalität. ARIA vermittelt nur das beabsichtigte Verhalten Ihrer Funktionalität.

Beim Erstellen einer Menüleiste sollte ein übergeordnetes Menüelement aria-haspopup="menu" (oder true) gesetzt haben. Jeder Button, der ein Menü öffnet, sollte die Rolle eines Buttons haben oder vorzugsweise ein <button> sein und ebenfalls aria-haspopup="menu" (oder true) gesetzt haben. Tab-Elemente mit Popup-Menüs sollten ebenfalls aria-haspopup="menu" gesetzt haben. Beachten Sie, dass menubars nicht zur Erstellung der Navigation von Websites verwendet werden sollten.

Hinweis: Elemente mit der Rolle combobox haben implizit einen aria-haspopup-Wert von listbox.

Werte

false (Standard)

Das Element hat kein Popup.

true

Das Popup ist ein Menü.

Das Popup ist ein Menü.

listbox

Das Popup ist eine Listbox.

tree

Das Popup ist ein Baum.

grid

Das Popup ist ein Raster.

dialog

Das Popup ist ein Dialog.

Zugehörige Schnittstellen

Element.ariaHasPopup

Die ariaHasPopup-Eigenschaft, Teil der Element-Schnittstelle, gibt den Wert des aria-haspopup-Attributs wieder, das die Verfügbarkeit und den Typ des interaktiven Popups anzeigt, wie z. B. Menü oder Dialog, das durch ein Element ausgelöst werden kann.

ElementInternals.ariaHasPopup

Die ariaHasPopup-Eigenschaft der ElementInternals-Schnittstelle spiegelt den Wert des aria-haspopup-Attributs wider.

Zugehörige Rollen

Spezifikationen

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# aria-haspopup

Siehe auch