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 : rôle group

Le rôle group identifie un ensemble d'objets d'interface utilisateur qui n'est pas destiné à être inclus dans un résumé de page ou une table des matières par les technologies d'assistance.

Description

Le rôle group, le plus étroitement lié à l'élément HTML <fieldset>, il est utilisé pour identifier un ensemble d'objets d'interface utilisateur qui, par rapport à region, n'est pas destiné à être inclus dans le résumé ou la table des matières de la page.

Le rôle group doit être utilisé pour former une collection logique d'éléments ayant une fonctionnalité connexe, comme les enfants d'un widget tree formant une collection de frères et sœurs dans une hiérarchie, ou une collection d'éléments ayant le même conteneur dans un directory.

Lorsqu'un group est utilisé dans le contexte d'une list, limitez les enfants du group aux éléments listitem. Dans ce cas, il est recommandé d'utiliser plusieurs listes ordonnées ou non ordonnées, <ol> ou <ul>, avec des enfants <li> imbriqués.

Lorsqu'il est utilisé dans le contexte d'une listbox, les seuls enfants autorisés sont les éléments <option>. Dans ce cas, il est recommandé d'utiliser <select>, <option> et <optgroup> à la place.

Les éléments group peuvent être imbriqués.

Le rôle group ne doit pas être utilisé pour des sections majeures et perceptibles d'une page. Si une section est suffisamment significative pour être incluse dans la table des matières de la page, utilisez le rôle region ou un rôle de point de repère standard.

Lorsqu'un rôle est ajouté à un élément, le navigateur enverra un événement de groupe accessible aux produits de technologie d'assistance, qui pourront alors en informer l'utilisateur·ice.

Exemples

L'exemple de code HTML ci-dessous utilise le rôle group avec une vue tree :

html
<div id="tree1" role="tree" tabindex="-1">
  <div
    id="animals"
    class="groupHeader"
    role="presentation"
    aria-owns="animalGroup"
    aria-expanded="true">
    <img role="presentation" tabindex="-1" src="images/treeExpanded.gif" />
    <span role="treeitem" tabindex="0">Animaux</span>
  </div>
  <div id="animalGroup" role="group">
    <div id="birds" role="treeitem">
      <span tabindex="-1">Oiseaux</span>
    </div>
    <div
      id="cats"
      class="groupHeader"
      role="presentation"
      aria-owns="catGroup"
      aria-expanded="false">
      <img role="presentation" tabindex="-1" src="images/treeContracted.gif" />
      <span role="treeitem" tabindex="0">Chats</span>
    </div>
    <div id="catGroup" role="group">
      <div id="siamese" role="treeitem">
        <span tabindex="-1">Siamois</span>
      </div>
      <div id="tabby" role="treeitem">
        <span tabindex="-1">Tabby</span>
      </div>
    </div>
  </div>
</div>

L'exemple suivant utilise le rôle group avec un menu déroulant menu contenant des menuitem :

html
<div role="menu">
  <ul role="group">
    <li role="menuitem">Boîte de réception</li>
    <li role="menuitem">Archive</li>
    <li role="menuitem">Corbeille</li>
  </ul>
  <ul role="group">
    <li role="menuitem">Dossier personnalisé 1</li>
    <li role="menuitem">Dossier personnalisé 2</li>
    <li role="menuitem">Dossier personnalisé 3</li>
  </ul>
  <ul role="group">
    <li role="menuitem">Nouveau dossier</li>
  </ul>
</div>

Ce menu pourrait être construit en utilisant les éléments <select> et <option>. Dans ce cas, le rôle group serait le plus similaire à l'élément <optgroup>.

Spécifications

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# group

Voir aussi