ARIA : attribut aria-owns

L'attributaria-owns identifie un ou plusieurs éléments afin de définir une relation visuelle, fonctionnelle ou contextuelle entre un parent et ses éléments enfants lorsque la hiérarchie DOM ne peut pas être utilisée pour représenter cette relation.

Description

Chaque élément est le parent, un élément au même niveau ou l'enfant d'un autre élément. L'objet document, composé d'éléments HTML et de nœuds de texte, forme la base de l'arbre DOM. Le modèle d'objet d'accessibilité (AOM) s'appuie sur un DOM bien construit pour permettre aux technologies d'assistance de transmettre des informations pertinentes sur le contenu d'un document aux utilisateur·ice·s.

Il existe des circonstances où la mise en page visible à l'écran peut différer de la structure DOM sous-jacente en raison de la capacité de JavaScript à modifier le contenu et du CSS à modifier la mise en page. Dans ce cas, l'attributaria-owns peut être utilisé pour recréer une relation significative pour les technologies d'assistance qui consomment le DOM.

Lorsque des éléments semblent liés visuellement mais ne sont pas associés dans le DOM, l'attributaria-owns permet de créer dans la couche d'accessibilité la relation qui apparaît à l'écran pour être utilisée par les technologies d'assistance. Laseule raison d'inclurearia-owns est d'exposer une relation contextuelle parent/enfant aux technologies d'assistance lorsque la construction du DOM ne peut pas fournir cette relation.

Un « élément propriétaire » est tout ancêtre DOM d'un élément. Si un élément semble visuellement, fonctionnellement ou contextuellement « posséder » (être un ancêtre de) un élément, mais n'est pas réellement un ancêtre de l'élément dans le DOM, incluezaria-owns pour créer cette relation. Ajoutez l'attribut à l'élément propriétaire en faisant référence à l'élément non-enfant possédé (ou aux éléments) pour indiquer aux technologies d'assistance qu'un élément doit être traité comme un enfant.

La référence à l'ID d'un ou plusieurs éléments permet à n'importe quel élément de « posséder » n'importe quel autre élément avec une déclarationaria-owns. La valeur de l'attributaria-owns est une liste d'identifiants séparés par des espaces qui référence les identifiants d'un ou plusieurs éléments dans le document.

Note :Un élément « possédé » est tout descendant DOM de l'élément, tout élément définit comme enfant viaaria-owns, ou tout descendant DOM de l'enfant possédé. L'élément possédé pararia-owns devrait être un élément appartenant à un arbre parent séparé dans le DOM mais devant être traité comme un enfant de l'élément courant.

N'utilisez pasaria-owns comme substitut de la hiérarchie DOM. Si la relation est représentée dans le DOM, n'utilisez pasaria-owns.

Un élément enfant est, par défaut, la propriété de son parent DOM : dans ce cas,aria-owns ne doit pas être utilisé. Évitez d'utiliser l'attributaria-owns pour réorganiser des éléments enfants existants dans un ordre différent.

Lors de l'utilisation dearia-owns, assurez-vous de gérer l'ordre du focus^(angl.). Assurez-vous que l'ordre visuel du focus correspond à cet ordre de lecture pour les technologies d'assistance.

Un exemple d'utilisation dearia-owns inclut les sous-menus contextuels qui apparaissent visuellement positionnés près d'un menu parent, mais qui ne peuvent pas être imbriqués dans le DOM à l'intérieur du menu parent car cela affecterait la présentation visuelle. Dans ce cas, utilisezaria-owns pour présenter le sous-menu comme un enfant du menu parent pour un lecteur d'écran.

Note :L'attributaria-owns ne doit être utilisé que lorsque la relation parent/enfant ne peut pas être déterminée à partir du DOM.

Si un élément possède à la foisaria-owns et des enfants dans le DOM, l'ordre des éléments enfants :

Les enfants DOM courant d'abord,
Ensuite, les éléments référencés dansaria-owns.

Cet ordre peut être modifié en incluant les références d'ID des enfants DOM courant dans la valeuraria-owns.

La propriétéorder, faisant partie des mises en page flex ou grid, peut être utilisée pour modifier l'ordre des éléments flex et grid, les faisant apparaître dans un ordre différent de leur ordre dans le document source, créant une divergence de l'ordre logique des éléments. Bien qu'il puisse être tentant d'ordonner la couche d'accessibilité afin de correspondre aux changements d'ordre créés avec la propriété CSSorder, éviter à la fois la propriétéorder et l'attributaria-owns est la meilleure option.

Assurez-vous que vos éléments possédés n'ont qu'un seul propriétaire. Ne spécifiez pas l'id d'un élément dans l'attributaria-owns de plus d'un autre élément. Un élément ne peut avoir qu'un seul propriétaire.

Attention :Bien quearia-owns soit maintenant pris en charge^(angl.) dans tous les navigateurs modernes,aria-owns peut ne pas être exposé aux utilisateur·ice·s de macOS et iOS utilisant VoiceOver avant iOS 17.3 et macOS 14.3.

Valeurs

id list: Liste d'identifiants séparés par des espaces correspondant aux éléments possédés par l'élément courant

Interfaces associées

Element.ariaOwnsElements: La propriétéariaOwnsElements fait partie de l'interface de chaque élément.Sa valeur est un tableau de sous-classes deElement qui reflètent les référencesid dans l'attributaria-owns (avec quelques réserves).
ElementInternals.ariaOwnsElements: La propriétéariaOwnsElements fait partie de l'interface de chaque élément personnalisé.Sa valeur est un tableau de sous-classes deElement qui reflètent les référencesid dans l'attributaria-owns (avec quelques réserves).