Utilisation du rôle dialog

Cette technique présente l'utilisation du rôle dialog (en).

Le rôle dialog est utilisé pour marquer une fenêtre ou une boîte de dialogue d'application web qui sépare le contenu ou l'UI du reste de l'application web ou de la page. Visuellement, les boîtes de dialogues sont généralement placées par dessus le contenu de la page, à l'aide d'un calque (ou « Overlay »). Les boîtes de dialogue peuvent être non-modales (ce qui signifie qu'il est toujours possible d'interagir avec le contenu situé hors de la boîte de dialogue) ou modales (ce qui signifie qu'on ne peut interagir qu'avec le contenu de la boîte de dialogue).

Marquer un élément de dialogue avec le rôle dialog aide les technologies d'assistance à identifier le contenu des boîtes de dialogue comme étant regroupé et séparé du reste du contenu de la page. Cependant, le seul ajout de role="dialog" n'est pas suffisant pour rendre une boîte de dialogue accessible. De plus, il faut veiller à ce qui suit :

• La boîte de dialogue doit être correctement labélisée ;
• Le focus clavier doit être géré correctement.

Les sections ci-dessous décrivent comment ces deux exigences peuvent être satisfaites.

Labélisation

Bien qu'il ne soit pas obligatoire que la boîte de dialogue elle-même reçoive le focus, elle doit quand même besoin d'être labélisée. Le label donné à la boîte de dialogue fournira des informations contextuelles pour les contrôles interactifs qu'elle contient. En d'autres termes, le label de la boîte de dialogue agit comme label de regroupement pour les contrôles qu'elle contient. On peut comparer cela à la façon dont un élément <legend> fournit un label de regroupement pour les contrôles contenus dans un élément <fieldset>.

Si une boîte de dialogue a une barre de titre visible, le texte de cette barre peut être utilisé comme label pour la boîte elle-même. La meilleure façon de le faire est d'utiliser l'attribut aria-labelledby pour l'élément role="dialog". De plus, si la boîte de dialogue contient une description supplémentaire, en plus du titre de la boîte, le texte de la description peut être associé avec la boîte de dialogue à l'aide de l'attribut aria-describedby. Cette approche est illustrée dans l'extrait de code ci-dessous :

<div
  role="dialog"
  aria-labelledby="dialog1Title"
  aria-describedby="dialog1Desc">
  <h2 id="dialog1Title">
    Vos informations personnelles ont correctement été actualisées.
  </h2>

  <p id="dialog1Desc">
    Vous pouvez modifier vos informations personnelles à n’importe quel moment
    depuis la section « Compte utilisateur. »
  </p>

  <button>Fermer</button>
</div>

Gestion du focus

Une boîte de dialogue a des exigences particulières concernant la façon dont le focus clavier doit être géré :

• Les boîtes de dialogue doivent avoir au moins un contrôle focalisable. Pour de nombreuses boîtes de dialogues, ce contrôle sera un bouton « Fermer », « OK » ou « Annuler. » En plus de cela, les boîtes de dialogue peuvent contenir n'importe quelle quantité d'éléments focalisables, même des formulaires ou d'autres composants conteneurs comme des onglets.
• Quand la boîte de dialogue s'affiche à l'écran, le focus clavier devrait être placé sur le contrôle focalisable par défaut de la boîte de dialogue. Ce contrôle dépend de la fonction des boîtes de dialogue. Pour les boîtes de dialogue ne fournissant qu'un texte simple, ce pourra être un bouton « OK ». Pour les boîtes de dialogue contenant un formulaire, ce pourra être le premier champ à renseigner du formulaire.
• Pour la plupart des boîtes de dialogue, le comportement attendu est que l'ordre de tabulation de la boîte tourne, c'est-à-dire que le premier élément focalisable sera focalisé après que le dernier élément focalisable de la boîte de dialogue aura été atteint lorsque l'utilisateur tabule. En d'autres termes, l'ordre de tabulation doit être contenu par la boîte de dialogue.
• Si la boîte de dialogue peut être déplacée ou redimensionnée, assurez-vous que ces actions peuvent être exécutées par les utilisateurs de clavier tout comme les utilisateurs de souris. De la même façon, si une boîte de dialogue fournit certaines fonctionnalités, comme des barres d'outils ou des menus contextuels, celles-ci doivent également être accessibles et pouvoir être actionnées par les utilisateurs de clavier.
• Les boîtes de dialogue peuvent être modales ou non modales. Lorsqu'une boîte de dialogue modale s'affiche à l'écran, il n'est pas possible d'interagir avec le reste du contenu de la page. En d'autres termes, l'UI principale de l'application ou le contenu de la page est considéré comme temporairement désactivé tant que la boîte de dialogue modale est affichée. Pour les boîtes de dialogue non modales il est toujours possible d'interagir avec du contenu extérieur à la boîte lorsqu'elle est affichée. Pour les boîtes de dialogue non modales, il y devra toujours y avoir un raccourci clavier global permettant de déplacer le focus entre les boîtes de dialogue ouvertes et la page principale. Pour plus d'informations, lisez le guide Gérer les dialogues modaux et non modaux.

Lorsque le rôle dialog est utilisé, l'agent utilisateur doit faire la chose suivante :

• Présenter l'élément comme une boîte de dialogue à l'API accessibilité du système d'exploitation.

Lorsque la boîte de dialogue est correctement labélisée et que le focus est déplacé vers un contrôle à l'intérieur de la boîte, les lecteurs d'écran devraient annoncer le rôle accessible du dialogue, son nom et éventuellement sa description avant d'annoncer l'élément qui a reçu le focus.

Exemple 1 : une boîte de dialogue contenant un formulaire

<div
  role="dialog"
  aria-labelledby="dialog1Title"
  aria-describedby="dialog1Desc">
  <h2 id="dialog1Title">Formulaire de souscription</h2>

  <p id="dialog1Desc">
    Nous ne partageons pas ces informations avec des tierces parties.
  </p>

  <form>
    <p>
      <label for="firstName">Prénom</label>
      <input id="firstName" type="text" />
    </p>

    <p>
      <label for="lastName">Nom</label>
      <input id="lastName" type="text" />
    </p>

    <p>
      <label for="interests">Intérêts</label>
      <textarea id="interests"></textarea>
    </p>

    <p>
      <input type="checkbox" id="autoLogin" />
      <label for="autoLogin">Intérêts</label>
    </p>

    <p>
      <input type="submit" value="Enregistrer les informations" />
    </p>
  </form>
</div>

Exemple 2 : une boîte de dialogue basée sur un Fieldset comme contenu alternatif

Pour prendre en charge les navigateurs ou les produits de technologies d'assistance qui ne prennent pas ARIA en charge, il est également possible d'appliquer le balisage dialog à un élément fieldset comme contenu alternatif. Ainsi le titre de la boîte de dialogue sera toujours annoncé correctement :

<fieldset
  role="dialog"
  aria-labelledby="dialog1Title"
  aria-describedby="dialog1Desc">
  <legend>
    <span id="dialog1Title"
      >Vos informations personnelles ont correctement été actualisées.</span
    >
    <span id="dialog1Desc"
      >Vous pouvez modifier vos informations personnelles à n’importe quel
      moment depuis la section « Compte utilisateur ».</span
    >
  </legend>

  <button>Fermer</button>
</fieldset>

Exemples concrets

• jQuery-UI Dialog

• dialog (en)
• aria-labelledby (en)
• aria-describedby (en)

• Utiliser le rôle alertdialog