ARIA : attribut aria-activedescendant
L'attribut aria-activedescendant
identifie l'élément actuellement actif lorsque la sélection est sur un widget composite
, une combobox
, une textbox
, un group
ou une application
.
Description
La propriété aria-activedescendant
permet de gérer la sélection pour les technologies d'assistance sur des éléments interactifs contenant plusieurs descendants sélectionnables, comme les menus, grilles ou barres d'outils. Au lieu que le lecteur d'écran déplace la sélection entre les éléments possédés, aria-activedescendant
peut être utilisé sur un élément conteneur pour référencer l'élément actuellement actif, informant ainsi l'utilisateur·ice des technologies d'assistance de l'élément actif lors de la sélection.
Avec aria-activedescendant
, le navigateur conserve la sélection du DOM sur l'élément conteneur ou sur un élément de saisie qui contrôle ce conteneur. Cependant, l'agent utilisateur communique les événements et états de sélection au bureau comme si l'élément référencé par aria-activedescendant
avait la sélection.
Cet attribut n'est pertinent que sur les éléments ayant le rôle de composite
, boîte combinée
, zone de saisie
, groupe
ou application
dont l'identifiant est référencé comme valeur de l'attribut.
L'attribut permet d'informer les technologies d'assistance de l'élément ayant la sélection, mais ne crée pas réellement la sélection. Le changement de sélection et la gestion de la valeur de l'attribut se font en JavaScript. En plus de gérer cette valeur, assurez-vous que le descendant actif est visible et affiché (ou défilé dans la vue) lors de la sélection.
Lors de la définition de la valeur de aria-activedescendant
sur un élément ayant la sélection DOM, assurez-vous que la valeur référence un élément possédé : soit un descendant de l'élément ayant la sélection DOM, soit un descendant logique indiqué par l'attribut aria-owns
.
Lorsque l'élément ayant la sélection DOM est une boîte combinée, une zone de saisie ou une zone de recherche, incluez aria-controls
pour référencer l'élément qui prend en charge aria-activedescendant
.
La valeur de aria-activedescendant
référence un élément possédé par l'élément contrôlé. Par exemple, dans une boîte combinée, la sélection peut rester sur la boîte combinée tandis que la valeur de aria-activedescendant
sur cet élément référence un descendant d'une liste déroulante contrôlée par la boîte combinée.
Note :
L'attribut n'est pris en charge que sur quelques rôles. Par exemple, les « boîtes de dialogue » (dialog
) ne prennent pas en charge aria-activedescendant
. Lorsqu'une boîte combinée ouvre une boîte de dialogue, la sélection DOM passe de la boîte combinée à la boîte de dialogue, qui ne peut pas être référencée par cet attribut.
Note :
Lorsqu'un descendant d'une « liste déroulante » (listbox
), d'une grille (grid
) ou d'une arborescence (tree
) contextuelle reçoit la sélection, la sélection DOM reste sur la boîte combinée et celle-ci possède aria-activedescendant
défini sur une valeur qui référence l'élément sélectionné dans la fenêtre contextuelle.
Valeurs
- Référence d'identifiant
-
prend comme valeur l'identifiant (
id
) de l'élément actuellement sélectionné.
Interfaces associées
Element.ariaActiveDescendantElement
-
La propriété
ariaActiveDescendantElement
fait partie de l'interface de chaque élément. Sa valeur est une instance d'une sous-classe deElement
qui reflète la référence d'identifiant dans l'attributaria-activedescendant
(avec certaines limites). ElementInternals.ariaActiveDescendantElement
-
La propriété
ariaActiveDescendantElement
fait partie de l'interface de chaque élément personnalisé. Sa valeur est une instance d'une sous-classe deElement
qui reflète la référence d'identifiant dans l'attributaria-activedescendant
(avec certaines limites).
Rôles associés
Pertinent uniquement comme attribut sur les éléments ayant les rôles suivants :
Spécifications
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA)> # aria-activedescendant> |