Guidelines : Accessibilité

Statut : Recommandation (REC)

Bonnes pratiques d'accessibilité numérique appliquées par l'agence web Alsacreations.fr, évoluant dans le temps et adaptées à chaque nouveau projet.

Ce document est divisé en trois parties :

  1. La Checklist (ensemble des points à respecter)
  2. Les Explications techniques détaillées (s'y référer lorsqu'un point de la Checklist n'est pas clair)
  3. Les Ressources d'accessibilité (liens et outils)

Checklist Niveau 1 (base) 🥉

HTML

CSS

Formulaires

  • Vérifier l'accessibilité des formulaires notamment l'usage au clavier.
  • Indiquer clairement les champs obligatoires.
  • Toujours associer une étiquette <label> à son champ respectif (avec for et id).
  • Utiliser l'élément <fieldset> associé à <legend> pour regrouper les champs par thématique.
  • Indiquer les formats attendus lorsqu'il y en a ; ne pas utiliser l'attribut placeholder comme indication (privilégier label), il ne doit fournir qu'un exemple d'usage.
  • Associer correctement une erreur à son champ.
  • Associer un autocomplete pour les champs demandant une donnée personnelle (nom, prénom, e-mail, adresse, etc.).

Design

  • Les contrastes et tailles de texte/liens/boutons sont suffisants.

Médias

  • Toutes les images doivent comporter un attribut alt ; il doit être vide alt="" pour les images décoratives et renseigné pour les images apportant du contenu.
  • Lorsqu'un lien renvoie vers un téléchargement de fichier, il faut indiquer : son intitulé, son poids, son format et l'ouverture dans une nouvelle fenêtre.
  • Rendre les fichiers SVG accessibles : décoratifs ou non, inline ou non, dans un bouton / lien ou non.

Checklist Niveau 2 (étendue) 🥈

  • Tester l'affichage des pages avec un niveau de zoom de 200%.
  • Utiliser un lecteur audio/vidéo accessible, par exemple les éléments HTML5 natifs.
  • Vérifier la cohérence de la tabulation et adapter si nécessaire avec tabindex.

Checklist Niveau 3 (demandes spécifiques) 🥇

  • Tester avec un lecteur d'écran.
  • Fournir une piste de sous-titres avec le format webVTT et l'élément <track> pour les vidéos.
  • Fournir une alternative textuelle (une retranscription) aux formats audio.
  • Rendre les fichiers PDF accessibles ou fournir une alternative HTML, .doc, .odt structurée.
  • Utiliser l'attribut aria-live judicieusement sur les informations provenant de chargements AJAX ou dévoilées dynamiquement par JavaScript.
  • Ajouter une modale de personnalisation d'affichage telle que l'outil AccessConfig (ou autre).
  • Rendre chaque script compatible avec les technologies d'assistance.

Explications techniques détaillées

Structure générale

Chaque page doit être correctement structurée afin de définir des zones aussi appelées regions (en-tête, pied de page, contenu principal, navigation et moteur de recherche).

Sémantique HTML

Chaque page doit avoir déclaré le type de document ainsi que la langue principale du contenu.

<!DOCTYPE html>
<html lang="fr">
    ...
</html>

Titres

Chaque page doit être organisée selon une structure de titres et de sous-titres hiérarchisés. Chaque titre doit être balisé avec un élément HTML <hx> allant du niveau 1 (<h1>) au niveau 6 (<h6>), <h1> étant le niveau le plus important. Nous conseillons :

  • d'avoir toujours un titre de niveau 1 <h1> et que celui-ci ne structure pas le titre du site commun à toutes les pages mais plutôt le titre du contenu courant
  • d'éviter les sauts dans les niveaux de titres : pas de titre <h4> après un titre <h2>

Voir aussi https://access42.net/en-tetes-non-conformite-wcag-clarification-titre/

La hiérarchie peut être testée avec l'extension Headings Map pour Chrome ou Headings Map pour Firefox.

Zone d’en-tête principale

<header role="banner">[…]</header>

La balise <header> peut être utilisée plusieurs fois dans la page mais l’attribut role="banner" ne doit être utilisé qu’une seule fois.

Pied de page

<footer role="contentinfo">[…]</footer>

La balise <footer> peut être utilisée plusieurs fois dans la page mais l’attribut role="contentinfo" ne doit être utilisé qu’une seule fois.

Zone de contenu principal

<main role="main">[…]</main>

La balise <main> ne peut être utilisée qu’une seule fois dans la page ainsi que l’attribut role="main".

Navigation

Chaque ensemble de pages doit proposer au moins deux moyens de navigation différents parmi la liste suivante :

  • Un menu de navigation
  • Un plan du site
  • Un moteur de recherche interne

Le menu de navigation, les barres de navigation (fil d'ariane par exemple) et le moteur de recherche (si existant) doivent toujours être affichés et atteignables de la même manière y compris au clavier.

Utiliser des combinaisons <ul><li> (liste non ordonnée) pour structurer les menus de navigation (principale ou secondaire) dans un élément <nav role="navigation”> :

  • Le menu principal du site (souvent affiché dans l’en-tête)
  • Un menu secondaire affiché dans certaines pages internes (parfois dans une barre latérale)
  • Un menu secondaire affiché dans le pied de page
  • Un fil d’ariane
  • Une pagination
  • Une table des matières

La balise <nav> peut-être utilisée plusieurs fois, avec l'attribut role="navigation". Dans le cas où plusieurs navigations sont utilisées au sein d'une page, elles doivent être différenciées en précisant un nom à chacune des zones avec l'attribut aria-label.

Exemple :

<nav role="navigation" aria-label="Menu principal">[…]</nav>

Tabulation et tabindex

L'attribut tabindex permet de capturer l’ordre du focus selon le nombre qu’on lui attribue (permettant de passer d'un élément focusable à l'autre avec la touche tab). Un ordre logique est "naturellement" créé en suivant les éléments interactifs du DOM (liens, boutons, champs...). Il comprend tous les nombres positifs à partir de 0.

Il faut éviter de toucher aux valeurs positives de tabindex cela pourrait aller à l'encontre de l'ordre "naturel" dans le document.

On peut utiliser :

  • -1 : rend un élément focusable sans le rendre navigable au clavier ; s'il est ajouté sur un élément interactif, celui-ci perdra le focus.
  • 0 : l'élément peut capturer le focus et être atteint via la navigation au clavier.

Les éléments pouvant recevoir le focus autres que nativement <a>, <input>, <button>, <select>, <textarea> (entre autres) pourront être équipés de tabindex="0".

Pour en savoir plus : MDN : tabindex

Moteur de recherche

Le rôle role="search" doit être ajouté à l'élément HTML englobant le formulaire de recherche. Dans le cas où plusieurs recherches se trouvent au sein d'une page, elles doivent être différenciées en précisant un nom à chacune des zones via l'attribut aria-label.

<div role="search" aria-label="Moteur de recherche principal">
  <form>[…]</form>
</div>

Plus d’informations : https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/Search_role/

Liens d’évitement ("skip link")

Un lien d'évitement vers le contenu principal est nécessaire. D'autres liens d'évitement peuvent être ajoutés pour accéder rapidement à la navigation, à la recherche, au pied de page, etc.

  • Il doit être le premier lien de la page.
  • Il peut être masqué par défaut (classe Tailwind sr-only) mais doit devenir visible lors du focus.
  • Si le contenu principal est un élément non interactif il faut ajouter tabindex="-1" pour rendre cet élément focusable (ex. sur une balise <main>). Voir la partie sur les tabindex.

Voici le lien d'évitement employé au sein du Design System du W3C :

<body>
  <a href="#main" class="skip-link">Skip to content</a>
  […]
  <main role="main" id="main" tabindex="-1">
.skip-link {
  background-color: #f9dc4a;
  border: solid 3px #000;
  color: #000;
  padding: 0.625em 0.9375em;
  text-decoration: none;
}
.skip-link:not(:focus):not(:active) {
  border: 0;
  clip: rect(0 0 0 0);
  -webkit-clip-path: inset(100%);
  clip-path: inset(100%);
  height: 1px;
  overflow: hidden;
  padding: 0;
  position: absolute;
  white-space: nowrap;
  width: 1px;
}
.skip-link:focus {
  left: 0;
  position: absolute;
  top: 0;
  z-index: 999;
}

Titres de page

Le titre de la page doit être pertinent et de préférence unique pour chaque page. Dans <title>, éviter le caractère | (pipe) comme séparateur. Préférer : (deux-points).

Pour une page de résultats de recherche, il faut indiquer dans le titre le mot recherché ainsi que la page actuelle si une pagination est présente : "Vous avez recherché le mot : xxx - page 2"

Listes

Les listes doivent être correctement structurées dans le code. Il existe 3 types de listes :

  • ordonnée (numérotée)
  • non ordonnée (à puces)
  • de définitions

Liste ordonnée :

<ol>
    <li>Étape 1</li> 
    <li>Étape 2</li>
    <li>Étape 3</li>
</ol>

Liste non ordonnée :

<ul>
    <li>100g de farine</li>
    <li>30cl d'eau</li>
</ul>

Liste de définitions (ex : glossaire) :

<dl>
    <dt>Terme</dt>
    <dd>Définition</dd>
</dl>

Liens

Un lien <a> mène vers une nouvelle page, un nouveau contexte de navigation. À ne pas confondre avec un bouton <button> ou <input type="button"> qui déclenche une action sans nécessairement changer de page (ex : déployer un menu, révéler un bloc).

Intitulés des liens

Tous les liens doivent avoir un intitulé explicite, un lien "vide" n’est pas accessible.

Exemple :

Liens vers les réseaux sociaux Liens vers les réseaux sociaux

Ne pas faire :

<a href="#" class="link-facebook"></a>
.link-facebook {
  display: block;
  height: 2rem;
  width: 2rem;
  background-image: url('facebook.png');
}

→ dans ce cas, le lecteur d’écran retranscrit l’intégralité de l’URL.

Même en ajoutant un attribut title="Retrouvez-nous sur Facebook" sur le lien, celui-ci reste considéré comme vide. De plus, il n’est pas sûr à 100% que l’attribut title soit correctement restitué par le lecteur d’écran (tout dépend de la configuration de l’utilisateur).

À faire :

<a href="#" class="link-facebook">
  <span class="sr-only">Retrouvez-nous sur Facebook</span>
</a>
.link-facebook {
  display: block;
  height: 2rem;
  width: 2rem;
  background-image: url('facebook.png');
}

→ dans ce cas, le lecteur d’écran retranscrit bien "Retrouvez-nous sur Facebook".

Ouverture dans une nouvelle fenêtre (lien externe)

Signaler lorsqu’un lien s’ouvre dans une nouvelle fenêtre :

<a href="#" target="_blank" aria-label="Lire l’article (nouvelle fenêtre)">Lire l’article</a>
<!-- ou -->
<a href="#" target="_blank" title="Lire l’article (nouvelle fenêtre)">Lire l’article</a>
<!-- ou -->
<a href="#" target="_blank" title="Lire l’article (nouvelle fenêtre)">Lire l’article 
    <img src="picto.svg" alt="nouvelle fenêtre">
    <!-- ou -->
    <span class="sr-only">nouvelle fenêtre</span>
</a>

Lien explicite

Un lien explicite permet de comprendre facilement sa fonction. L'intitulé doit être réfléchi en amont dans les phases de design / conception, ou de contribution.

Exemple : "GO", ou "OK" ne correspondent pas à des intitulés explicites.

Un lien peut devenir explicite grâce à son contexte. Par exemple :

  • Le contenu de la phrase dans laquelle le lien texte est présent ;
  • Le contenu du paragraphe (balise <p>) dans lequel le lien texte est présent ;
  • Le contenu de l'item de liste (balise <li>) ou le contenu d'un item de liste parent (balise <li>) dans lequel le lien texte est présent ;
  • Le contenu du titre (balise <hx>) précédent le lien texte ;
  • Le contenu de la ou les cellule(s) d'en-tête de tableau (balise(s) <th>) associée(s) à la cellule de donnée (balise <td>) dans laquelle le lien texte est présent ;
  • Le contenu de la cellule de donnée (balise <td>) dans laquelle le lien texte est présent.

<!-- Contexte du contenu de la phrase / paragraphe  -->
<p>Le document RGAA 4.1 a été mis à jour. <a href="#">En savoir plus</a></p>

<!-- Contexte du titre -->
<article>
    <h2>Document RGAA 4.1</h2>
    <p>Le document RGAA 4.1 a été mis à jour</p>
    <a href="#">Lire l'article</a>
</article>

Attribut title

L'attribut title permet d'ajouter une infobulle native qui apparaît au survol. Cet attribut doit être utilisé uniquement pour apporter une information complémentaire.

Pour utiliser correctement title, il faut reprendre l'intitulé du lien :

<a href="#" target="_blank" title="En savoir plus (ouvre une nouvelle fenêtre)">En savoir plus</a>

Nous recommandons d'utiliser cette méthode lorsque les liens ouvrent une nouvelle fenêtre (target="_blank"). Il ne fonctionne cependant pas sur écrans tactiles pour lesquels il n'existe pas de survol avec un curseur.

Lien image

Lorsqu'un lien n'est composé que d'une image, c'est le texte alternatif de l'image qui devient l'intitulé du lien.

<a href="#"><img src="logo.png" alt="Retour à l'accueil"></a>

Lien icône

Lorsqu'un lien n'est composé que d'une icône générée en CSS (les font-icon par exemple), il est important de :

  • Rendre explicite le lien avec un texte masqué (classe CSS .sr-only)
  • Masquer l'icône aux lecteurs d'écran
  • (optionnel si l'icône n'est pas parlante) Ajouter un attribut title sur le lien.
<a href="#">
    <span class="icone" aria-hidden="true"></span>
    <span class="sr-only">Retour à l'accueil</span>
</a>

Lien composite

Un lien composite est un lien composé d'un texte et d'une image. Dans ce cas, si le texte est explicite : l'image est décorative.

Dans le cas où l'image apporte une information, le texte alternatif peut être renseigné.

<!-- Texte explicite -->
<a href="#">Retour à l'accueil <img src="home.png" alt=""></a>

<!-- Lien avec une image porteuse d'informations -->
<a href="#">Statut : <img src="loading.png" alt="en cours"></a>

<!-- Lien icône générée en CSS -->
<a href="#">Statut :
    <span class="icone" aria-hidden="true"></span>
    <span class="sr-only">En cours</span>
</a>

Formulaires et champs

Ne pas enlever les styles au focus pour toujours savoir quel est le champ actif.

Utiliser l'élément <fieldset> associé à <legend> pour regrouper les champs ayant trait à la même thématique. Exemple : coordonnées du visiteur lors d'une commande en ligne :

<form>
  <fieldset>
    <legend>Vos coordonnées</legend>

    <input type="text" id="name" name="name" autocomplete="family-name">
    <label for="name">Nom</label>

    <input type="email" id="email" name="email" autocomplete="email">
    <label for="email">Email</label>
  </fieldset>
</form>

Lier correctement un champ à son étiquette

Chaque champ d'entrée (input, textarea, etc) doit être correctement visuellement accolé à son étiquette.

Tous les champs doivent être correctement liés à leur étiquette associée (<label>). Pour cela, chaque étiquette doit avoir un attribut for qui a pour valeur l'identifiant (id) du champ correspondant.

<form>

    <label for="city">Ville</label>
    <input type="text" id="city" name="ville_personne">

</form>

Mention obligatoire

Lorsqu'un champ est obligatoire, il doit être :

  • indiqué de manière visuelle : en ajoutant la mention obligatoire dans chaque étiquette, soit avec une indication qui est explicitée en début de formulaire (avant le premier champ).
  • indiqué dans le code : par un attribut required ou aria-required="true".
<form>
    <!-- mention obligatoire dans chaque étiquette -->
    <label for="name">Nom (obligatoire)</label>
    <input type="text" id="name" name="name" required>
</form>

<form>
    <!-- indication qui est explicitée en début de formulaire -->
    <p>Les champs signalés par l'indication (*) sont obligatoires</p>
    <label for="name">Nom (*)</label>
    <input type="text" id="name" name="name" required>
</form>

Aide à la saisie

Lorsqu'un champ attend un format particulier ou possède une limite de caractères entrés, il est nécessaire de l'indiquer pour aider l'internaute à renseigner le formulaire.

L'indication doit être correctement lié à son champ, et peut être placée soit :

  • dans l'étiquette (<label>),
  • dans le passage de texte (les attributs suivants ont pour valeur l'identifiant (id) de l'indication) :
    • Soit dans l'intitulé (lié avec un attribut aria-labelledby)
    • Soit en tant que description du champ (lié avec un attribut aria-describedby qui a pour valeur l'identifiant (id) de l'indication).
<form>
    <!-- Indication dans l'étiquette -->
    <label for="name">E-mail (format attendu : john@example.org)</label>
    <input type="text" id="name" name="name">

    <!-- Indication dans la description du champ -->
    <label for="name">E-mail</label>
    <input type="text" id="name" name="name" aria-describedby="format-email">
    <p id="format-email">format attendu : john@example.org</p>
</form>

Les placeholders (attribut placeholder) ne constituent pas une technique correcte pour nommer ou donner des précisions à un champ. Premièrement à cause d'un contraste souvent insuffisant et d'autre part car cette indication disparaît pendant la saisie puis une fois que le champ est renseigné.

Associer un autocomplete pour les champs demandant une donnée personnelle (nom, prénom, e-mail, adresse, etc.). Voir la liste complète des valeurs de autocomplete..

<label for="name">Nom</p>
<input type="text" id="name" name="name" autocomplete="family-name">

Erreur de saisie

Lorsqu'un formulaire retourne des erreurs, les champs erronés doivent être indiqués dans le code, et de manière visuelle. Les messages d'erreurs doivent être explicites et placés de manière à identifier nommément le champ concerné.

Le message d'erreur d'un champ doit être lié soit :

  • dans l'étiquette (<label>),
  • dans le passage de texte (les attributs suivants ont pour valeur l'identifiant (id) de l'indication) :
    • Soit dans l'intitulé (lié avec un attribut aria-labelledby).
    • Soit en tant que description du champ (lié avec un attribut aria-describedby).
    <label for="name">E-mail (format attendu : john@example.org)</label>
    <input type="text" id="name" name="name" aria-invalid="true" aria-labelledby="erreur-email">
    <p id="erreur-email">Le format attendu n'est pas correct.</p>

Voir WebAIM : Usable and Accessible Form Validation and Error Recovery.

Details et summary

Les éléments details et summary sont accessibles dans la pupart des cas en respectant des bonnes pratiques, voir The details and summary elements, again.

Tableaux

N'utiliser les tableaux que pour la présentation de données, et non pour la structure du document ou de la mise en page (design).

  • Définir un titre pertinent avec <caption> placée juste après la balise d’ouverture <table>.
  • Les cellules d’en-têtes doivent être déclarées avec la balise <th>. Et les cellules de données avec <td>.
  • Sur les cellules d’en-tête il est nécessaire d’ajouter l’attribut scope afin de les lier aux cellules de données. Il prend pour valeur :
    • col : s’applique à toutes les cellules de la colonne.
    • row : s’applique à toutes les cellules de la ligne.
<table>
 <caption>Quantité de fruits mangés par jour</caption>
  <thead>
   <tr>
      <th scope="col">Kiwi</th>
      <th scope="col">Orange</th>
      <th scope="col">Myrtille</th>
   </tr>
  </thead>
  <tbody>
    <tr>
      <td>10</td>
      <td>30</td>
      <td>42</td>
     </tr>
  </tbody>
</table>

Tableaux complexes

Dans le cas des tableaux complexes, scope ne suffit pas pour lier l’en-tête à ses cellules de données.

Il faut ajouter l’attribut id sur la cellule d'en-tête, et headers avec la valeur de l’id sur la cellule de donnée :

<table>
  <caption>Nombre de fruits avec pépins, et avec noyau. Et nombre de légumes avec ou sans peau</caption>
  <thead>
    <tr>
      <th id="fruits" colspan="2">Fruits</th>
      <th id="legumes" colspan="2">Légumes</th>
    </tr>
    <tr>
      <th id="data1" headers="fruits">avec pépins</th>
      <th id="data2" headers="fruits">avec noyau</th>
      <th id="data3" headers="legumes">avec peau</th>
      <th id="data4" headers="legumes">sans peau</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td headers="fruits data1">14</td>
      <td headers="fruits data2">25</td>
      <td headers="legumes data3">33</td>
      <td headers="legumes data4">30</td>
    </tr>
  </tbody>
</table>

Changement de langue

Pour tout changement de langue dans le contenu, il est nécessaire de les indiquer avec un attribut lang. Ce changement ne s'applique pas pour les noms propres ni les noms communs de langue étrangère présent dans le dictionnaire officiel de la langue (ex: week-end pour le dictionnaire Français).

L'attribut lang prend pour valeur le code langue selon la norme ISO 693-1.

<a href="#">Voir le document en anglais (<span lang="en">english</span>)</a>
<a href="#">Voir le document en allemand (<span lang="de">deutsch</span>)</a>

Changement de sens de lecture

Dans le cas où le sens de lecture change, il faut l'indiquer avec un attribut dir qui peut avoir 2 valeurs :

  • ltr (left to right) indique un sens de lecture de gauche à droite
  • rtl (right to left) indique un sens de lecture de droite à gauche
<p lang="ar" dir="rtl">شكرا جزيلا</p>

Sans indication, le sens de lecture est par défaut de gauche à droite (ltr).

Navigation au clavier

La navigation au clavier se fait via la tabulation (touche Tab du clavier ; Shift+Tab en arrière) sur tous les éléments interactifs focusables : boutons, liens, champs de formulaire, sélecteur, etc. Ce focus est indiqué par un contour visuel (propriété outline en CSS qu'il est impératif de conserver, ou proposer une alternative avec focus-visible).

  • Le site doit être intégralement utilisable au clavier.
  • L'ordre de tabulation doit être cohérent.
  • Il ne doit pas y avoir de piège au clavier (si l'internaute ne peut atteindre ni l'élément focusable suivant, ni l'élément focusable précédent).

Bonnes pratiques ARIA

WAI-ARIA est une technologie permettant de donner des indications d'accessibilité supplémentaires par rapport aux comportements natifs déjà prévus par les navigateurs pour les éléments HTML de base.

Trois caractéristiques principales sont définies dans la spécification :

  • les attributs role (landmarks), voir la Matrice des rôles ARIA
  • les propriétés, par exemple aria-label ou aria-required.
  • les états, par exemple aria-disabled

ARIA est aussi recommandé pour les composants complexes pilotés par JavaScript (ex : menus déroulants, sliders, onglets, modales, etc.).

Voir https://www.w3.org/WAI/ARIA/apg/patterns/

Voici un exemple d'usage de l'attribut aria-label :

<button aria-label="accéder au code Hypertext markup language">html</button>

Cet exemple est issu d'un article des Guidelines Accessibilité de Orange nommé Les attributs ARIA qui peuvent vous sauver ! décrivant en détail les différences d'usage de aria-label, aria-labelledby et aria-describedby.

Bonnes pratiques CSS

Exploiter les préférences en CSS avec CSS Media Features : prefers-color-scheme, forced-colors, inverted-colors, prefers-contrast, prefers-reduced-transparency, prefers-reduced-motion, prefers-reduced-data.

outline et focus

Les éléments interactifs (liens, champs, boutons) affichent un contour lorsqu'ils réagissent au :focus, c'est à dire au clic, au touch ou à la navigation clavier (les 3).

Ce contour correspond à la propriété CSS outline (ce n'est pas une border ni un box-shadow).

L'ensemble des navigateurs appliquent par défaut un outline visible lors de l'événement :focus et, même si nous pourrions trouver cela disgracieux, il est important de ne pas le supprimer autour des éléments cliquables (pas de outline: none) car il a été conçu pour rendre ces éléments accessibles à tous (= se repérer lors d'une navigation au clavier).

Grâce à la pseudo-classe :focus-visible il est possible de masquer le contour (focus) lors du clic ou d'un touch, tout en le préservant lors d'un focus au clavier.:

@supports selector(div:focus-visible) {
  /* uniquement au clic/tap focus */
  .custom-button:focus:not(:focus-visible) {
    outline-color: transparent;
  }
  /* uniquement au focus clavier */
  .custom-button:focus-visible {
    outline: 6px dashed hotpink;
  }
}

Voir le support et tester sur CodePen

CSS generated content

On peut générer du contenu en CSS à l’aide de ::before et ::after et la propriété content, pour afficher une icône par exemple (gérée via une font-icon).

Mais la plupart des lecteurs d’écrans actuels peuvent retranscrire ce contenu, ce qui peut provoquer une gêne (voir https://tink.uk/accessibility-support-for-css-generated-content).

Pour éviter cela, il est préférable d’insérer l’attribut aria-hidden="true" sur l’élément.

Exemple :

<a href="#" class="btn"> <i class="icon-kiwi" aria-hidden="true"></i> KiwiParty </a>

Contenu lu mais masqué à l’écran

Ne jamais utiliser display: none pour masquer visuellement du texte qui devrait être retranscrit par un lecteur d’écran. Utiliser plutôt la classe .sr-only, présente dans Tailwind ou .visually-hidden, présente dans Bootstrap. Cette astuce CSS permet de cacher visuellement du contenu texte mais tout en restant accessible aux lecteurs d’écrans. Lire aussi Accessibilité Numérique Orange : Exemple masquage accessible et aria-hidden.

.sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border-width: 0;
}

Exemple :

Bouton Bouton "précédent" d’un slider

Ne pas faire :

<button class="btn-icon swiper-button-prev">
  <i class="icon-arrow" aria-hidden="true"></i>
  <span>Éléments précédents</span>
</button>
.swiper-button-prev span {
  display: none;
}

À faire :

<button class="btn-icon swiper-button-prev">
  <i class="icon-arrow" aria-hidden="true"></i>
  <span class="sr-only">Éléments précédents</span>
</button>

Bonnes pratiques Images

Dans tous les cas, les images (<img>) doivent obligatoirement posséder un attribut alt.

Image porteuse d’information ou cliquable

Une image porteuse d’information ou cliquable doit avoir une alternative textuelle, l’attribut alt doit reprendre l’information figurant sur l’image.

Exemple d’une image cliquable :

KNACSS

<a href="www.knacss.com">
  <img src="knacss.png" alt="Knacss">
</a>

Exemple d’une image porteuse d’information :

4,9 milliards € sont consacrés à la modernisation - 10 millions € - 700km

<img src="banner.png" alt="4,9 milliards € sont consacrés à la modernisation […] - 10 millions € […] - 700km">

Attention : inutile de débuter l’attribut alt="Image : …", cette information sera retranscrite par les lecteurs d’écrans lors de la lecture de l’élément <img>.

Image décorative

Une image décorative doit avoir un attribut alt vide afin que l’image ne soit pas retranscrite par les lecteurs d’écrans.

Exemple d’une image de décoration :

image alt text

<img src="kiwiparty.png" alt="">

Images SVG et accessibilité

Les exemples à suivre proviennent du Design System du W3C ainsi que de l'article Contextually Marking up accessible images and SVGs et Les images SVG sont de plus en plus utilisées sur le web mais qu’en est-il de leur accessibilité ?.

Important : Toujours commencer par nettoyer proprement les fichiers SVG (avec SVGOMG) car les éditeurs graphiques ajoutent de nombreux éléments inutiles tels que des <title> de type "créé par Sketch".

Image SVG porteuse d'information

Cas d'un SVG inline :

Ajouter l'attribut role="img" pour indiquer aux lecteurs d'écrans de la considérer comme une image et lui éviter de lire tous les nœuds HTML du SVG. Il faut ensuite ajouter un <title> (ou un aria-label) pour expliciter la fonction de l'image. Ajouter également focusable="false"pour éviter que la touche Tab ne navigue au sein du SVG.

<svg role="img" focusable="false" aria-labelledby="title">
  <title id="title">Le nom accessible</title>
  <use xlink:href="#svg-id-to-reference" aria-hidden="true" />
  <!-- contenu du SVG -->
</svg>

ou bien (si l'infobulle au survol n'est pas souhaitée) :

<svg role="img" aria-label="Nom accessible" focusable="false">
  <use xlink:href="#..." aria-hidden="true"></use>
</svg>

Cas d'une image SVG :

Ajouter l'attribut role="img".

<img src="image.svg" role="img" alt="Nom accessible">

Image SVG décorative

Les images au format SVG qui sont décoratives doivent être correctement ignorées. Pour cela, l'élément <svg> :

  • doit avoir l'attribut aria-hidden="true"
  • ne doit pas contenir d'éléments <title> ni <desc>
  • ne doit pas contenir d'attribut title, aria-label, aria-labelledby, role="img"
  • avoir un attribut focusable="false" pour éviter de naviguer au sein du SVG.
<svg aria-hidden="true" focusable="false"><!-- contenu du SVG --></svg>
<!-- ou -->
<img src="image.svg" alt="" aria-hidden="true">

Dans le cas d'une image SVG à portée informative, l'élément <svg> doit avoir :

  • un attribut role="img"
  • un intitulé avec soit l'attribut aria-label, soit avec un élément <title> (lié avec l'attribut aria-labelledby qui reprend l'identifiant (id) de l'élément <title>.)
  • avoir un attribut focusable="false" pour éviter de naviguer au sein du SVG.
<!-- Le SVG a un intitulé avec l'attribut aria-label -->
<svg role="img" aria-label="Démarche en cours" focusable="false"></svg>

<!-- Le SVG a un intitulé avec l'élément <title> -->
<svg role="img" aria-labelledby="title-svg" focusable="false">
  <title id="title-svg">Démarche en cours</title>
</svg>

SVG dans lien ou dans un bouton

La méthode aria-label="Nom accessible" est mal supportée par certaines assistances techniques lorsque le SVG est contenu dans un lien ou un bouton.

Il est préférable d'utiliser un <span> invisible pour le nom accessible s'il doit être masqué à l'écran, le texte sera alors retranscrit par les lecteurs d’écrans.

Cas d'un SVG inline :

<a href="#">
  <svg aria-hidden="true" focusable="false">
    <!-- contenu du SVG -->
  </svg>
  <span class="sr-only">Nom accessible masqué à l'écran</span>
</a>

Cas d'une image SVG :

<a href="#">
  <img src="image.svg" alt="">
  Nom accessible visible à l'écran
</a>

Image complexe

Une image complexe est une image contenant beaucoup d'informations, comme un graphique par exemple. Dans ce cas, il est nécessaire de décrire toute l'image dans une description détaillée qui peut se trouver soit :

  • sur la page en elle-même : en dessous ou à côté de l'image
  • ou sur une autre page

Le texte alternatif de l'image (alt) doit être renseigné.

Description détaillée sur la page

<img src="graphique.jpg" alt="Données numériques (description détaillée ci-dessous)">
<p>Description détaillée
    …
</p>

Si la description est trop longue, elle peut être masquée de manière accessible avec un accordéon. Sinon, il est possible d'utiliser une description détaillée n'importe où sur la page via l'attribut longdesc sur l'image avec pour valeur l'identifiant (id) de cette description détaillée.

<img src="image.url" alt="Données numérique" longdesc="#description">
<div>
    …
</div>
<div id="description">
    <p>Description détaillée
        …
    </p>
</div>

Description détaillée sur une autre page

Pour cela, il faut utiliser un attribut longdesc sur l'image (<img>) ayant pour valeur l'adresse (URL) de la page contenant la description détaillée.

<!-- La page page-de-la-description-detaillee.html regroupera la description détaillée de l'image.-->
<img src="image.url" alt="Données numérique" longdesc="https://example.org/page-de-la-description-detaillee.html">

Bonnes pratiques design

Voir Guidelines Design : checklist accessibilité

Bonnes pratiques médias

Les multimédias (vidéos, sons) nécessitent des précautions :

  • Chaque média doit être identifiable : un titre ou un paragraphe le précède afin de comprendre le contenu présenté.
  • Les médias ne doivent pas être déclenchés automatiquement.
  • Ils doivent être contrôlables :
    • Au minimum dotés des boutons de pause, lecture et stop.
    • Si le média est sonore, un contrôle pour activer / désactiver le son.
    • Si le média a des sous-titres, un contrôle pour activer / désactiver les sous-titres.
    • Si le média a une audiodescription, un contrôle pour activer / désactiver l'audiodescription.
  • Le média doit proposer une alternative accessible. Selon le média, il doit proposer :
    • soit une audiodescription synchronisée (ou disponible via un lien ou bouton adjacent) pour les médias vidéos ou synchronisés.
    • soit une alternative audio (ou disponible via un lien ou bouton adjacent) seulement pour les médias vidéos.
    • soit des sous-titres synchronisés, si nécessaire, pour les médias synchronisés.
    • soit une transcription textuelle (adjacente ou disponible via un lien ou bouton adjacent) pour tous les types de médias.

Bonnes pratiques Javascript

ARIA

Si WCAG concerne plutôt le contenu web "statique", WAI-ARIA est une technologie améliorant l'accessibilité supplémentaires par rapport aux comportements natifs déjà prévus par les navigateurs pour les éléments HTML de base. Trois caractéristiques principales sont définies dans la spécification :

  • les attributs role (landmarks), voir la Matrice des rôles ARIA
  • les propriétés, par exemple aria-label ou aria-required.
  • les états, par exemple aria-disabled souvent géré par JavaScript.

Pour tous les composants de page agissant sur le contenu, de type swiper, slider, slideshow, accordéon, pagination, onglets, menu déroulant, on privilégiera les scripts "accessibles", y compris ceux utilisant ARIA. Le but étant, entre autres, de ne pas gêner la navigation au clavier et de permettre la lecture de la page avec une synthèse vocale.

ARIA live

Utiliser l'attribut aria-live sur les informations provenant de chargements asynchrones (API, fetch, XHR) ou générées par JavaScript dynamiquement, non présentes naturellement dans le flux de la page comme des alertes, par exemples les rôles log, status, alert, progressbar, marquee, timer.

<div role="alert" aria-live="assertive" aria-atomic="true">
  <p>Message envoyé avec succès / Article ajouté au panier</p>
</div>

On pourra moduler avec aria-atomic et aria-relevant (additions, removals, text, all) selon qu'on ajoute le contenu au conteneur ou que c'est lui-même qui se voit inséré dans le corps de la page.

Autres composants

Pour tous les composants de page agissant sur le contenu, de type swiper, slider, slideshow, accordéon, pagination, onglets, menu déroulant, on privilégiera les scripts "accessibles", y compris ceux utilisant ARIA. Le but étant, entre autres, de ne pas gêner la navigation au clavier et de permettre la lecture de la page avec une synthèse vocale.

Pour les menus déroulants et mega menus, Accessible Mega Menu a fait ses preuves.

Ressources Générales

Outils

Contraste / Webdesign

Plugins

Synthèses vocales

Checklist contribution

Bonnes pratiques à respecter lorsqu'on contribue au contenu, notamment à l'aide d'un éditeur visuel dans un CMS (Content Management System) tel que WordPress, Drupal, Joomla ou équivalent :

  • Ne pas justifier le texte.
  • Utiliser une taille de police suffisante.
  • Ne pas gérer l'espacement avec des sauts de ligne.
  • Expliciter les abréviations et acronymes, au moins pour la première occurence dans la page à l'aide de abbr.
  • Rédiger les dates dans des formats explicites (le mois en toutes lettres, l'année complète sur 4 chiffres).
  • Déclarer les changements de langue.

Liens dans le contenu

  • Rédiger des liens explicites.
  • Indiquer le titre / format / poids / langue (si différente du document) des fichiers en téléchargement (par exemple documents PDF).
  • Prévenir l'ouverture d'un lien dans une nouvelle fenêtre.
  • Un élément cliquable doit être de taille suffisante.

Structuration

  • Utiliser correctement la hiérarchie des titres.
  • Utiliser des listes à puces (ordonnées et non ordonnées).
  • Utiliser les citations (bloc de citation et en incise).
  • Utiliser des tableaux pour présenter des données.

Images

  • Ajouter ou non une alternative textuelle aux images.
  • Images informatives complexes : rédiger une description détaillée.

Couleurs & présentations

  • Utiliser des contrastes de couleurs suffisants (entre le texte et le fond).
  • Ne pas véhiculer d'information uniquement par la couleur.
  • Ne pas faire référence à un élément en se basant sur sa position, sa couleur ou sa forme.