# L'interface et le CSS

Échelle fermée, composants partagés, téléphone, accessibilité.


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.

:::note[En bref]
- **UI-01** · [Utilisez l'échelle fermée](#ui-01--utilisez-léchelle-fermée)
- **UI-02** · [N'écrivez pas de style en ligne](#ui-02--nécrivez-pas-de-style-en-ligne)
- **UI-03** · [Donnez un nom à chaque couleur](#ui-03--donnez-un-nom-à-chaque-couleur)
- **UI-04** · [Reprenez le composant partagé](#ui-04--reprenez-le-composant-partagé)
- **UI-05** · [Écrivez un état par un seul composant](#ui-05--écrivez-un-état-par-un-seul-composant)
- **UI-06** · [Choisissez la largeur pour la page, pas pour son contenu](#ui-06--choisissez-la-largeur-pour-la-page-pas-pour-son-contenu)
- **UI-07** · [Mettez les filtres dans les en-têtes de colonnes](#ui-07--mettez-les-filtres-dans-les-en-têtes-de-colonnes)
- **UI-08** · [Pensez le téléphone comme un autre écran](#ui-08--pensez-le-téléphone-comme-un-autre-écran)
- **UI-09** · [Faites de tout geste un bouton ou un lien](#ui-09--faites-de-tout-geste-un-bouton-ou-un-lien)
- **UI-10** · [Donnez un libellé à chaque champ](#ui-10--donnez-un-libellé-à-chaque-champ)
- **UI-11** · [Rendez tout possible au clavier](#ui-11--rendez-tout-possible-au-clavier)
:::

## L'échelle et les composants

### UI-01 · Utilisez l'échelle fermée

:::tip[Règle]
Les tailles de texte, espaces, hauteurs, arrondis et gris viennent d'une échelle courte, déclarée à un seul endroit. Ce qui n'y est pas ne s'écrit pas.
:::

<div class="avant-apres">

```ts title="À éviter"
<div className="gap-[13px] text-[15px]">
```

```ts title="À faire"
<div className="gap-3 text-sm">
```

</div>

<span class="puce relecture">Relecture</span> ESLint ne contrôle pas les valeurs entre crochets de Tailwind.

### UI-02 · N'écrivez pas de style en ligne

:::tip[Règle]
Une classe de l'échelle, ou une règle de la feuille, jamais un attribut `style`.
:::

<div class="avant-apres">

```ts title="À éviter"
<div style={{ marginTop: 13, color: "#e8472b" }}>
```

```ts title="À faire"
<div className="mt-3 text-alerte">
```

</div>

<span class="puce outil">Outil</span> Une règle ESLint refuse l'attribut `style`.

### UI-03 · Donnez un nom à chaque couleur

:::tip[Règle]
Une couleur a un nom et une seule définition, déclarée dans la feuille des fondations avant d'être utilisée.
:::

<div class="avant-apres">

```css title="À éviter"
.bandeau { background: #e8472b; }
```

```css title="À faire"
.bandeau { background: var(--alerte); }
```

</div>

<span class="puce outil">Outil</span> Un test vérifie le contraste de chaque thème.

### UI-04 · Reprenez le composant partagé

:::tip[Règle]
Un tableau, une fenêtre, un sélecteur, un choix de fichier ou de semaine existent déjà. On les reprend, on ne les récrit pas.
:::

| À é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` |

<span class="puce outil">Outil</span> 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

:::tip[Règle]
Un état s'écrit partout pareil : un point de couleur, puis le mot, par le composant d'état. Le mot vient de la table des états.
:::

<span class="puce relecture">Relecture</span> L'absence de liste d'états écrite dans un écran se relit.

## La mise en page

### UI-06 · Choisissez la largeur pour la page, pas pour son contenu

:::tip[Règle]
La largeur se choisit selon le type d'écran. Le tableau remplit sa page et défile dans son cadre s'il ne tient pas. La page ne défile jamais de côté.
:::

| À é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 |

<span class="puce relecture">Relecture</span> Le choix du type de largeur se relit.

### UI-07 · Mettez les filtres dans les en-têtes de colonnes

:::tip[Règle]
Les filtres vivent dans l'en-tête de leur colonne, et le compte d'un filtre suit les autres filtres.
:::

<span class="puce relecture">Relecture</span> Le composant de tableau et de filtre en est la mise en œuvre.

### UI-08 · Pensez le téléphone comme un autre écran

:::tip[Règle]
Cibles tactiles de 44 px, champs de 16 px. Un téléphone n'est pas un écran de bureau réduit.
:::

**Pourquoi.** Sous 16 px, certains navigateurs zooment à la saisie.

<span class="puce outil">Outil</span> 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é

### UI-09 · Faites de tout geste un bouton ou un lien

:::tip[Règle]
Un geste cliquable est un `button` ou un lien, jamais un `div` ou un `span` avec un `onClick`.
:::

**Pourquoi.** Un `div` cliquable n'est ni atteignable au clavier ni annoncé par un lecteur d'écran.

<div class="avant-apres">

```ts title="À éviter"
<div onClick={ouvrir}>Ouvrir</div>
```

```ts title="À faire"
<button type="button" onClick={ouvrir}>Ouvrir</button>
```

</div>

<span class="puce outil">Outil</span> Les règles `jsx-a11y` d'ESLint refusent un élément cliquable sans clavier.

### UI-10 · Donnez un libellé à chaque champ

:::tip[Règle]
Chaque champ a un libellé lié (`label`, ou `aria-label` sans texte visible).
:::

<div class="avant-apres">

```ts title="À éviter"
<input name="nom" />
```

```ts title="À faire"
<label htmlFor="nom">Nom</label>
<input id="nom" name="nom" />
```

</div>

<span class="puce relecture">Relecture</span> Le libellé des champs se relit.

### UI-11 · Rendez tout possible au clavier

:::tip[Règle]
Le focus se voit, Échap ferme une fenêtre, le focus revient d'où il venait. Le texte se lit sur son fond : contraste d'au moins 4,5 pour 1 (3 pour 1 pour un grand texte).
:::

<span class="puce outil">Outil</span> Un test vérifie le contraste de chaque thème.

<span class="puce relecture">Relecture</span> Le focus et Échap se relisent.

## 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 |

## Voir aussi

- [Les textes des écrans](/regles/textes/)
- [Nommer le reste (CSS)](/regles/nommage-autres/)
