Que fait frontend ?
Normes pour les interfaces utilisateur navigateur que de vraies personnes utilisent avec des claviers, des lecteurs d'écran, des téléphones lents et des imprimantes. Les règles ci-dessous sont celles qui sont souvent ignorées lorsque l'UI "a l'air terminée".
Règles les plus importantes
- Utilisez l'élément qui signifie la chose.
<button>pour les actions,<a href>pour la navigation,<label>pour chaque champ,<table>pour les données tabulaires. Un<div>avec un gestionnaire de clic n'est pas focalisable, n'a pas de rôle et est invisible pour les technologies d'assistance. ARIA ne comble que les lacunes qu'un élément natif ne peut pas. - Chaque vue asynchrone a quatre états : chargement, erreur, vide et données. Écrivez les quatre avant de considérer la vue comme terminée. Une région vide est un bug.
- Ne fabriquez jamais de données. Une période manquante est un trou ou une étiquette "Aucune donnée", jamais zéro et jamais une ligne interpolée. Les prévisions sont toujours visiblement distinctes des réalisations.
- Ne signalez jamais uniquement par la couleur. Chaque état codé par couleur porte également un texte ou une icône avec un nom accessible. L'impression en niveaux de gris et les lecteurs daltoniens n'obtiennent rien autrement.
- L'état partageable vit dans l'URL. Filtres, onglets, termes de recherche, identifiants sélectionnés. Le retour, l'actualisation et le partage doivent le conserver. L'état éphémère (survol, une infobulle ouverte) ne va pas dans l'URL.
- Une valeur dérivée de plusieurs éléments d'état reçoit une fonction, appelée chaque fois que l'un d'eux change. Ne la calculez jamais à l'intérieur du rappel qui appartient à l'un d'eux. Exemple : un lien de téléchargement construit à partir d'une date limite et d'un filtre de groupe n'était reconstruit que dans le rappel de récupération de la date limite, donc après un changement de filtre, l'export pointait silencieusement vers la liste entière.
- Reflow à partir de 320 px CSS. Pas de défilement horizontal de la page, pas de contenu tronqué, texte redimensionnable à 200%. Testez à une largeur de téléphone ainsi qu'à la largeur de bureau pour laquelle vous avez conçu.
- Adaptez les outils au besoin. Dans un dépôt existant, suivez le framework et le build déjà en place. Pour une petite nouvelle page ou un outil interne, envisagez du HTML, CSS et un peu de JavaScript simple avant d'ajouter un pipeline de build ; optez pour un framework lorsque l'état le justifie véritablement.
Quand ne pas l'utiliser
- Choix d'une direction visuelle, d'une typographie ou d'une palette : les compétences
designeretvisual-design. - iOS natif, Android ou React Native : la compétence
mobile(etswiftpour le code Swift). - Forme de l'API et points de terminaison serveur : les compétences
api-designetbackend-patterns. - Technique de test en profondeur : les compétences
tddettesting-strategy.
Où vit l'état
Décidez avant d'écrire l'état du composant. Commencez localement et escaladez uniquement pour une raison énoncée.
| État | Domicile | Exemple |
|---|---|---|
| UI locale | État du composant | Modale ouverte, brouillon de saisie, survol |
| Partagé par des frères | Parent commun le plus proche | Onglet actif lu par deux panneaux |
| Données serveur | Une bibliothèque de cache serveur (TanStack Query, SWR) ou le loader du framework | Réponses API, pagination, rechargement |
| État client à l'échelle de l'application | Un petit store, seulement si nécessaire | Utilisateur connecté, file d'attente de notifications |
| État de vue partageable | Requête URL ou route | Filtres, recherche, identifiant sélectionné |
| Survit au rechargement, par appareil | localStorage | Préférences, brouillons non envoyés |
Escaladez uniquement lorsque : deux composants non liés ont besoin du même état (remontez-le, ou utilisez le cache serveur) ; l'état doit survivre au rechargement (URL ou stockage) ; les données proviennent d'un serveur (cache serveur, pas un store global). Les données serveur copiées dans un store global deviennent obsolètes et dupliquent la logique de chargement et d'erreur.
Graphiques, impression et vues simplifiées
- Graphiques : une carte de couleurs partagée par le front-end et le back-end, un état vide explicite, des lacunes honnêtes, une légende
HTML. Lisez
references/charts.mdavant de construire ou de modifier un graphique. - Impression ou PDF : lisez
references/print.mdavant de construire une vue imprimable. Les toiles ne s'impriment pas de manière fiable sans l'étape de capture qu'il décrit. - Vues simplifiées ou en lecture seule pour les lecteurs non techniques : pas de contrôles d'édition, texte généreux et tailles de cible grandes, statut en couleur et en mots, résumés en langage simple calculés à partir des données, peu d'écrans, et chiffres clés avec des phrases courtes au lieu de tableaux bruts.
Performances
Corrigez par ordre d'impact : d'abord les cascades de requêtes, puis le JavaScript livré, puis le temps de réponse serveur,
puis le travail du thread principal pendant l'interaction et les micro-optimisations en dernier. Objectifs : LCP 2,5s ou moins, INP
200ms ou moins, CLS 0,1 ou moins au 75e percentile des visites réelles. Lisez references/performance.md
lorsqu'une page est lente, avant d'ajouter une dépendance lourde ou avant un lancement avec des objectifs de performance.
Pièges
- Les chemins de rendu sont des boucles chaudes. Un corps de composant ou un getter calculé s'exécute à chaque survol et à chaque changement d'état non lié. Une dérivation lourde y affame le thread principal, et le premier symptôme peut être un test instable ailleurs. Dédupliquez, puis mémorisez sur les entrées en amont.
- Une propriété CSS personnalisée non déclarée échoue silencieusement.
var(--mono)alors que le token est--font-monorend la déclaration invalide au moment du calcul de la valeur : la propriété hérite, sans erreur. Dans une propriété abrégée (font: 400 10px/1 var(--mono)), la taille et la hauteur de ligne sont également perdues. Donnez àvar()une valeur de repli ou vérifiez les tokens déclarés par rapport à ceux référencés dans la feuille de style finale. - La hauteur d'un graphique va sur son conteneur. Une hauteur sur la
canvasentre en conflit avec la logique de redimensionnement de la bibliothèque et le graphique s'agrandit à chaque redimensionnement. - Le focus est votre travail dans les widgets personnalisés. Ouvrir une boîte de dialogue déplace le focus à l'intérieur ; fermer ramène le focus à
l'élément déclencheur ; Échap ferme. Préférez l'élément natif
<dialog>. Reconstruire le balisage avecinnerHTMLperd le focus. outline: nonesans remplacement supprime le seul repère qu'ont les utilisateurs de clavier. Utilisez:focus-visiblepour le styliser à la place.- Les boutons avec seulement une icône ont besoin d'un nom (
aria-labelou texte caché visuellement). - Le contenu qui n'existe qu'après une récupération client est lent sur les appareils faibles, vide lorsque JavaScript échoue et plus faible pour les robots d'indexation. Rendez le contenu significatif sur le serveur lorsque la pile le permet.
- Les médias non dimensionnés déplacent la mise en page. Définissez
widthetheight(ouaspect-ratio) sur les images, les vidéos et les intégrations. Ne chargez jamais en différé l'image qui est le plus grand élément au-dessus de la ligne de flottaison. - Les menus déroulants, onglets et curseurs faits à la main ont besoin du modèle de clavier complet des Pratiques de création WAI-ARIA. Un élément natif est presque toujours moins cher.
- Un faux DOM écrit à la main peut rendre les tests inertes. Si le faux renvoie un nouvel objet par recherche, chaque
propriété écrite (
href,disabled,value) est perdue et aucune assertion à son sujet ne peut échouer. Revenez sur la fonctionnalité et exigez que le test échoue avant de lui faire confiance. - Une version CDN épinglée, jamais une version non épinglée. Un script non épinglé change sous vos pieds sans commit.
Vérification
Prouvez-le avec ce que le projet a déjà (son exécuteur de tests, linter, vérificateur de types, outils d'accessibilité) avant d'ajouter de nouveaux outils.
- Les tests, le lint et la vérification de types réussissent. Tout nouveau test a été vu échouer avec la fonctionnalité annulée.
- La page a été rendue et regardée, à une largeur de téléphone et à une largeur de bureau. Dans la mesure du possible, donnez aux relecteurs un aperçu en cours d'exécution ainsi que des captures d'écran.
- Clavier uniquement : chaque contrôle atteignable, opérable et visiblement focalisé ; l'ordre correspond à l'ordre visuel ; pas de piège.
- Un audit d'accessibilité automatisé (axe, Lighthouse ou l'outil du projet) n'a pas de nouvelles violations. Contraste vérifié avec un outil : 4,5:1 pour le texte du corps, 3:1 pour le texte volumineux et les bordures des composants d'interface (WCAG AA).
- Les états de chargement, d'erreur, de vide et de données sont chacun affichés, en forçant chacun d'eux.
- L'état partageable survit à l'actualisation et au retour.
- La console a zéro erreur et zéro avertissement au chargement et pendant l'utilisation.
- Le budget de performance est vérifié si le changement ajoute une dépendance ou touche une vue lourde (analyseur de bundle, un profil limité).
- L'aperçu avant impression est vérifié si la page est imprimable.
Pour une révision, rapportez les résultats par fichier avec la règle enfreinte et le correctif, du plus grave au moins grave.