From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../index.html" | 89 ++++++++++++++++++++++ 1 file changed, 89 insertions(+) create mode 100644 "files/fr/accessibilit\303\251/aria/techniques_aria/utiliser_l_attribut_aria-describedby/index.html" (limited to 'files/fr/accessibilité/aria/techniques_aria/utiliser_l_attribut_aria-describedby') diff --git "a/files/fr/accessibilit\303\251/aria/techniques_aria/utiliser_l_attribut_aria-describedby/index.html" "b/files/fr/accessibilit\303\251/aria/techniques_aria/utiliser_l_attribut_aria-describedby/index.html" new file mode 100644 index 0000000000..44e25b657f --- /dev/null +++ "b/files/fr/accessibilit\303\251/aria/techniques_aria/utiliser_l_attribut_aria-describedby/index.html" @@ -0,0 +1,89 @@ +--- +title: Utiliser l’attribut aria-describedby +slug: Accessibilité/ARIA/Techniques_ARIA/Utiliser_l_attribut_aria-describedby +tags: + - ARIA + - Accessibilité + - Attribut +translation_of: Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-describedby_attribute +--- +

Description

+ +
+

Cette technique présente l’utilisation de l’attribut aria-describedby.

+
+ +

L’attribut aria-describedby est utilisé pour indiquer l’identifiant des éléments qui décrivent l’objet. Il est utilisé pour établir une relation entre des composants ou des groupes et un texte les décrivant. Il est similaire à aria-labelledby : un label décrit la nature d’un objet, tandis qu’une description fournit plus d’informations pouvant être utiles à l’utilisateur.

+ +

L’attribut aria-describedby n’est pas uniquement utilisé pour des éléments de formulaire ; il peut également être utilisé pour associer un texte statique avec des composants, des groupes d’éléments, des panneaux, des zones possédant un titre, des définitions, etc. La section {{ anch("Exemples") }} ci-dessous fournit plus d’informations sur l’utilisation de cet attribut dans ces cas précis.

+ +

Cet attribut peut être utilisé avec n’importe quel élément caractéristique de formulaire HTML ; il n’est pas limité aux éléments auxquels un rôle ARIA a été assigné.

+ +

Valeurs

+ +

Une liste d’ID d’éléments séparés par des espaces

+ +

Effets possibles sur les agents utilisateurs et les technologies d’assistance

+ +
Note : il existe plusieurs points de vue sur la façon dont les technologies d’assistance devraient traiter cette technique. L’information fournie ci-dessus est l’une de ces opinions et n’est pas normative.
+ +

Exemples

+ +

Exemple 1 : Descriptions des points de repère d’une application

+ +

Dans l’exemple ci-dessous, un paragraphe d’introduction décrit une application de calendrier. aria-describedby est utilisé pour associer le paragraphe avec le conteneur de l’application.

+ +
<div role="applicaton" aria-labelledby="calendar" aria-describedby="info">
+    <h1 id="calendar">Calendrier<h1>
+    <p id="info">
+        Ce calendrier affiche les prévisions de match du Racing Métro.
+    </p>
+    <div role="grid">
+        …
+    </div>
+</div>
+
+ +

Exemple 2 : Un bouton de fermeture

+ +

Dans l’exemple ci-dessous, un lien qui fonctionne comme le bouton Fermer d’une boîte de dialogue, est décrit ailleurs dans le document. L’attribut aria-describedby est utilisé pour associer la description au lien.

+ +
<button aria-label="Fermer" aria-describedby="descriptionClose"
+    onclick="myDialog.close()">X</button>
+…
+
+<div id="descriptionClose">La fermeture de cette fenêtre entraînera la perte des informations saisies et vous renverra vers la page principale</div>
+
+ +

Exemples concrets :

+ + + +

Notes

+ + + +

Utilisé par les rôles ARIA

+ +

Tous les éléments de balisage de base.

+ +

Techniques ARIA connexes

+ + + +

Compatibilité

+ +

À définir : ajouter les informations de prise en charge pour les combinaisons les plus courantes d’agents utilisateurs et de produits de technologies d’assistance.

+ +

Autres ressources

+ + -- cgit v1.2.3-54-g00ecf