Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

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 de Element qui reflète la référence d'identifiant dans l'attribut aria-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 de Element qui reflète la référence d'identifiant dans l'attribut aria-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