ARIA: aria-activedescendant Attribut
Das aria-activedescendant
Attribut identifiziert das derzeit aktive Element, wenn der Fokus auf einem composite
Widget, combobox
, textbox
, group
oder application
liegt.
Beschreibung
Die aria-activedescendant
Eigenschaft bietet eine Methode zur Verwaltung des Fokus für unterstützende Technologien auf interaktiven Elementen, wenn sie mehrere fokussierbare Nachfahren enthalten, wie zum Beispiel Menüs, Raster und Werkzeugleisten. Anstatt dass der Screenreader den Fokus zwischen untergeordneten Elementen bewegt, kann aria-activedescendant
auf Containerelementen verwendet werden, um auf das derzeit aktive Element zu verweisen, wodurch Benutzer unterstützt werden, die Technologie anwenden, um das derzeit aktive Element zu identifizieren, wenn der Fokus darauf liegt.
Mit aria-activedescendant
hält der Browser den DOM-Fokus auf dem Containerelement oder auf einem Eingabeelement, das das Containerelement steuert. Der Benutzeragent kommuniziert jedoch Desktop-Fokusereignisse und -zustände an die unterstützende Technologie, als ob das durch aria-activedescendant
referenzierte Element den Fokus hätte.
Dieses Attribut ist nur relevant für Elemente mit der Rolle composite
Widget, combobox
, textbox
, group
oder application
, deren id
als Attributwert referenziert wird.
Das Attribut verwaltet die Bereitstellung von Informationen für unterstützende Technologien darüber, welches Element den Fokus hat, erzeugt jedoch keinen tatsächlichen Fokus. Das Ändern des Fokus und die Verwaltung des Attributwertes erfolgt mit JavaScript. Zusätzlich zur Verwaltung dieses Attributwertes stellen Sie sicher, dass der derzeit aktive Nachfahre sichtbar ist und im Sichtfeld (oder in das Sichtfeld rollt) ist, wenn er fokussiert wird.
Beim Setzen des Wertes von aria-activedescendant
auf einem Element mit DOM-Fokus stellen Sie sicher, dass der Wert auf ein untergeordnetes Element verweist—entweder einen Nachfahren des Elements mit DOM-Fokus ODER einen logischen Nachfahren, wie durch das aria-owns
Attribut angezeigt.
Wenn das Element mit DOM-Fokus eine Combobox, ein Textfeld oder ein Suchfeld ist, fügen Sie aria-controls
hinzu, um auf das Element zu verweisen, das aria-activedescendant
unterstützt.
Der Wert von aria-activedescendant
verweist auf ein untergeordnetes Element des gesteuerten Elements. Zum Beispiel kann bei einer Combobox der Fokus auf der Combobox bleiben, während der Wert von aria-activedescendant
auf dem Combobox-Element auf einen Nachfahren einer Popup-Listbox verweist, die von der Combobox gesteuert wird.
Hinweis:
Das Attribut wird nur von wenigen Rollen unterstützt. Zum Beispiel unterstützen dialog
s nicht aria-activedescendant
. Wenn eine Combobox ein Dialogfeld öffnet, wechselt der DOM-Fokus vom Combobox ins Dialogfeld, da er mit diesem Attribut nicht referenziert werden kann.
Hinweis:
Wenn ein Nachfahre eines listbox
, grid
oder tree
Popups fokussiert ist, bleibt der DOM-Fokus auf der Combobox, und die Combobox hat aria-activedescendant
auf einen Wert gesetzt, der auf das fokussierte Element innerhalb des Popups verweist.
Werte
- ID-Referenz
-
nimmt als Wert die
id
des derzeit fokussierten Elements.
Zugehörige Schnittstellen
Element.ariaActiveDescendantElement
-
Die
ariaActiveDescendantElement
Eigenschaft ist Teil der Schnittstelle jedes Elements. Ihr Wert ist eine Instanz einer Unterklasse vonElement
, die dieid
-Referenz imaria-activedescendant
Attribut widerspiegelt (mit einigen Vorbehalten). ElementInternals.ariaActiveDescendantElement
-
Die
ariaActiveDescendantElement
Eigenschaft ist Teil der Schnittstelle jedes benutzerdefinierten Elements. Ihr Wert ist eine Instanz einer Unterklasse vonElement
, die dieid
-Referenz imaria-activedescendant
Attribut widerspiegelt (mit einigen Vorbehalten).
Zugehörige Rollen
Relevant nur als Attribut auf Elementen mit den folgenden Rollen:
Spezifikationen
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA) # aria-activedescendant |