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 menubar
s 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
Zugehörige Schnittstellen
Element.ariaHasPopup
-
Die
ariaHasPopup
-Eigenschaft, Teil derElement
-Schnittstelle, gibt den Wert desaria-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 derElementInternals
-Schnittstelle spiegelt den Wert desaria-haspopup
-Attributs wider.
Zugehörige Rollen
Verwendet in Rollen:
Vererbt in Rollen:
Spezifikationen
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA) # aria-haspopup |
Siehe auch
aria-controls
menu
listbox
tree
grid
dialog
- Toolbar example - W3C WAI ARIA Practices