L’interface est tenue par un petit nombre de règles strictes : c’est le premier endroit où un projet écrit par plusieurs mains se met à diverger.
L’échelle et les composants
Section intitulée « L’échelle et les composants »UI-01 · Utilisez l’échelle fermée
Section intitulée « UI-01 · Utilisez l’échelle fermée »<div className="gap-[13px] text-[15px]"><div className="gap-3 text-sm">Relecture ESLint ne contrôle pas les valeurs entre crochets de Tailwind.
UI-02 · N’écrivez pas de style en ligne
Section intitulée « UI-02 · N’écrivez pas de style en ligne »<div style={{ marginTop: 13, color: "#e8472b" }}><div className="mt-3 text-alerte">Outil Une règle ESLint refuse l’attribut style.
UI-03 · Donnez un nom à chaque couleur
Section intitulée « UI-03 · Donnez un nom à chaque couleur ».bandeau { background: #e8472b; }.bandeau { background: var(--alerte); }Outil Un test vérifie le contraste de chaque thème.
UI-04 · Reprenez le composant partagé
Section intitulée « UI-04 · Reprenez le composant partagé »| À éviter | À faire |
|---|---|
| Un tableau fait à la main | TableauFiltrable, un seul tableau par objet |
window.confirm("Supprimer ?"), alert, prompt |
Une fenêtre de l’application (Fenetre) |
Un <select> refait |
Selecteur |
Un <input type="file"> brut |
ChoixDeFichiers |
Outil Des règles ESLint refusent de récrire ces composants et d’appeler confirm, alert ou prompt.
UI-05 · Écrivez un état par un seul composant
Section intitulée « UI-05 · Écrivez un état par un seul composant »Relecture L’absence de liste d’états écrite dans un écran se relit.
La mise en page
Section intitulée « La mise en page »UI-06 · Choisissez la largeur pour la page, pas pour son contenu
Section intitulée « UI-06 · Choisissez la largeur pour la page, pas pour son contenu »| À éviter | À faire |
|---|---|
| Une largeur décidée d’après ce que l’écran montre | Étroite : réglages, formulaires, fiches. Standard : écrans de travail, listes. Grande : gros tableau. Large : très grands tableaux, planning |
Relecture Le choix du type de largeur se relit.
UI-07 · Mettez les filtres dans les en-têtes de colonnes
Section intitulée « UI-07 · Mettez les filtres dans les en-têtes de colonnes »Relecture Le composant de tableau et de filtre en est la mise en œuvre.
UI-08 · Pensez le téléphone comme un autre écran
Section intitulée « UI-08 · Pensez le téléphone comme un autre écran »Pourquoi. Sous 16 px, certains navigateurs zooment à la saisie.
Outil Un contrôle mesure chaque écran au format d’un téléphone et rend un rapport, sans bloquer la mise en ligne.
L’accessibilité
Section intitulée « L’accessibilité »UI-09 · Faites de tout geste un bouton ou un lien
Section intitulée « UI-09 · Faites de tout geste un bouton ou un lien »Pourquoi. Un div cliquable n’est ni atteignable au clavier ni annoncé par un lecteur d’écran.
<div onClick={ouvrir}>Ouvrir</div><button type="button" onClick={ouvrir}>Ouvrir</button>Outil Les règles jsx-a11y d’ESLint refusent un élément cliquable sans clavier.
UI-10 · Donnez un libellé à chaque champ
Section intitulée « UI-10 · Donnez un libellé à chaque champ »<input name="nom" /><label htmlFor="nom">Nom</label><input id="nom" name="nom" />Relecture Le libellé des champs se relit.
UI-11 · Rendez tout possible au clavier
Section intitulée « UI-11 · Rendez tout possible au clavier »Outil Un test vérifie le contraste de chaque thème.
Relecture Le focus et Échap se relisent.
Référence rapide
Section intitulée « Référence rapide »| Règle | À retenir | Tenue par |
|---|---|---|
| UI-01 | Utilisez l’échelle fermée | Relecture |
| UI-02 | N’écrivez pas de style en ligne | Outil |
| UI-03 | Donnez un nom à chaque couleur | Outil |
| UI-04 | Reprenez le composant partagé | Outil |
| UI-05 | Écrivez un état par un seul composant | Relecture |
| UI-06 | Choisissez la largeur pour la page, pas pour son contenu | Relecture |
| UI-07 | Mettez les filtres dans les en-têtes de colonnes | Relecture |
| UI-08 | Pensez le téléphone comme un autre écran | Outil |
| UI-09 | Faites de tout geste un bouton ou un lien | Outil |
| UI-10 | Donnez un libellé à chaque champ | Relecture |
| UI-11 | Rendez tout possible au clavier | Outil, Relecture |