Formation

Un cours en autonomie pour une équipe qui adopte Lily : huit modules, chacun avec un objectif, une lecture, un exercice à faire dans un vrai navigateur et une auto-évaluation avec les réponses. Une journée environ en tout ; un module par séance convient bien.

Avant de commencer

Choisissez un tutoriel de framework et terminez-le d'abord. Lancez l'une des applications d'exemple en local, ou utilisez les pages des composants de ce site, pour les exercices. Il vous faut un clavier et, pour le module 8, un lecteur d'écran : VoiceOver sur macOS et iOS, NVDA sur Windows ou TalkBack sur Android, tous gratuits.

Module 1 — Ce que veut dire headless

Objectif : savoir ce que Lily décide et ce que vous décidez.

Lire : la page À propos, et une page de composant, par exemple Button, du début à la fin.

Faire : affichez un Button et un TextInput sans feuille de style. Puis liez un thème, puis un autre. Notez ce qui a changé et ce qui n'a pas changé.

Auto-évaluation : que ne fournit jamais un composant Lily ? Que fournit-il toujours ?

Jamais : de CSS, de polices, d'icônes ni d'images (sauf les icônes des sélecteurs), de texte anglais, de récupération de données, de langue ou de devise par défaut. Toujours : l'élément HTML le plus précis, sa classe en kebab-case en premier, de l'ARIA là où le HTML ne suffit pas, le comportement au clavier, et vos autres attributs transmis.

Auto-évaluation : vous voulez une bordure rouge sur un bouton. Où la mettre ?

Dans votre CSS, sur la classe (.button) ou sur une classe que vous ajoutez. Jamais dans le composant.

Module 2 — Clavier et focus

Objectif : utiliser et tester chaque composant sans souris.

Lire : le tableau des interactions clavier de TabBar, Listbox et Dialog.

Faire : débranchez la souris. Sur chacune de ces trois pages, atteignez la démo avec Tab et faites tout ce que liste le tableau. Ouvrez la boîte de dialogue, appuyez sur Escape, et notez où arrive le focus.

Auto-évaluation : pourquoi une barre d'onglets ne prend-elle qu'un arrêt de Tab et pas un par onglet ?

Le modèle composite de l'APG : Tab passe d'un widget à l'autre, et les flèches se déplacent à l'intérieur (un index de tabulation itinérant). Une barre de dix onglets à dix arrêts oblige une personne au clavier à appuyer dix fois sur Tab pour la franchir.

Auto-évaluation : après la fermeture d'une boîte de dialogue modale, où doit être le focus ?

Sur le contrôle qui l'a ouverte. Les boîtes de dialogue modales de Lily utilisent showModal(), qui garde aussi Tab à l'intérieur de la boîte tant qu'elle est ouverte.

Module 3 — Noms, rôles et états

Objectif : donner à chaque contrôle un nom qu'un lecteur d'écran peut prononcer, avec vos mots.

Lire : la section ARIA de IconButton et SwitchButton.

Faire : dans votre propre application, avec son serveur de développement, affichez un IconButton sans son label. Ouvrez la console du navigateur : Lily signale que le contrôle n'a pas de nom accessible. Ajoutez l'étiquette et vérifiez que l'avertissement disparaît. (Les avertissements n'existent que dans une version de développement : une page de production, comme ce site, reste silencieuse.)

Auto-évaluation : quand utiliser aria-label, et quand un texte visible ?

Un texte visible chaque fois que possible : tout le monde le voit, et les personnes qui utilisent la commande vocale peuvent le prononcer. aria-label seulement quand il n'y a pas de texte visible, par exemple pour une icône. Si les deux existent, le nom doit contenir les mots visibles (WCAG 2.5.3).

Auto-évaluation : un statut affiché seulement en rouge. Que manque-t-il ?

Du texte. La couleur peut répéter un sens mais jamais le porter seule (WCAG 1.4.1) ; le statut a besoin de mots.

Module 4 — Formulaires

Objectif : construire un formulaire dont tout le monde peut trouver et corriger les erreurs.

Lire et faire : le tutoriel des formulaires accessibles, les cinq étapes.

Auto-évaluation : la validation du formulaire échoue. Où va le focus, et qu'est-ce qui est lu ?

Au récapitulatif des erreurs, annoncé avec son titre et sa liste de liens, un par erreur, chacun menant à son champ.

Auto-évaluation : pourquoi ne pas désactiver le bouton d'envoi tant que le formulaire n'est pas valide ?

Un bouton désactivé ne peut pas dire ce qui ne va pas, et beaucoup de gens ne comprennent pas pourquoi il ne fait rien.

Module 5 — Thèmes et contraste

Objectif : restyler Lily sans casser le contraste ni le focus.

Lire : le tutoriel des thèmes et le tableau de contraste des thèmes .

Faire : remplacez --color-primary par la couleur de votre marque. Vérifiez que sa paire, --color-primary-content, atteint 4,5:1, et que l'anneau de focus reste visible sur la page.

Auto-évaluation : la couleur de votre marque est trop pâle pour du texte blanc. Pouvez-vous encore l'utiliser ?

Oui, en décoration (--lily-brand : un bandeau d'en-tête, un filet, un fond de logo), jamais pour du texte ni pour la bordure d'un contrôle. Le texte et les bordures utilisent les paires de contenu du thème.

Module 6 — International

Objectif : ne faire d'aucun pays le pays par défaut.

Lire et faire : un formulaire qui fonctionne partout dans le monde.

Auto-évaluation : pourquoi CurrencyInput n'a-t-il pas de devise par défaut ?

Toute valeur par défaut serait l'argent d'un seul pays, fausse en silence partout ailleurs. Un currencyCode manquant est un défaut chez l'appelant.

Auto-évaluation : une page en arabe. Que définissez-vous, et que doit faire votre CSS ?

lang="ar" et dir="rtl" (le sélecteur de langue définit les deux) ; votre CSS utilise des propriétés logiques pour que la mise en page se reflète d'elle-même.

Module 7 — Animations

Objectif : animer sans nuire à personne.

Lire : les recettes d'animation.

Faire : activez « réduire les animations » dans votre système et rechargez une page avec la recette du défilant. Il doit rester immobile et passer à la ligne. Puis atteignez son bouton de pause au clavier.

Auto-évaluation : quelque chose bouge seul pendant plus de cinq secondes. Que doit-il avoir ?

Un moyen de le mettre en pause, de l'arrêter ou de le masquer (WCAG 2.2.2), accessible au clavier, pas seulement au survol.

Module 8 — Vérifier votre travail

Objectif : tester une page comme Lily teste les siennes.

Faire : prenez une page construite pendant ce cours et faites quatre vérifications :

  1. axe (l'extension du navigateur, ou @axe-core/playwright dans un test) : aucune violation.
  2. Clavier seul : chaque tâche faite, focus toujours visible, jamais piégé.
  3. Zoom à 400 % et fenêtre réduite à 320 pixels : pas de défilement horizontal, rien de coupé.
  4. Un lecteur d'écran : chaque contrôle a un nom, un rôle et son état, et les erreurs sont annoncées.
Auto-évaluation : axe ne signale aucune violation. La page est-elle accessible ?

Pas encore prouvé. Les tests automatiques trouvent peut-être un tiers des problèmes ; le clavier, le zoom et le lecteur d'écran trouvent une grande partie du reste. Voyez la page qualité pour ce que Lily lui-même a vérifié ou non.

Après le cours