@etic-insa/ui 0.3.0 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +110 -73
- package/dist/components/etic/app-shell.d.ts +4 -1
- package/dist/components/etic/app-shell.js +150 -113
- package/dist/components/etic/app-shell.js.map +1 -1
- package/dist/components/etic/data-table-bulk-actions.d.ts +15 -2
- package/dist/components/etic/data-table-bulk-actions.js +100 -53
- package/dist/components/etic/data-table-bulk-actions.js.map +1 -1
- package/dist/components/etic/data-table-focus.d.ts +1 -1
- package/dist/components/etic/data-table-focus.js.map +1 -1
- package/dist/components/etic/data-table.d.ts +12 -4
- package/dist/components/etic/data-table.js +199 -223
- package/dist/components/etic/data-table.js.map +1 -1
- package/dist/components/etic/delete-button.d.ts +2 -2
- package/dist/components/etic/delete-button.js.map +1 -1
- package/dist/components/etic/detail-list.d.ts +3 -1
- package/dist/components/etic/detail-list.js +1 -1
- package/dist/components/etic/detail-list.js.map +1 -1
- package/dist/components/etic/disclosure.js +1 -0
- package/dist/components/etic/disclosure.js.map +1 -1
- package/dist/components/etic/icon-toggle.js +1 -1
- package/dist/components/etic/icon-toggle.js.map +1 -1
- package/dist/components/etic/page-header.d.ts +12 -4
- package/dist/components/etic/page-header.js +27 -16
- package/dist/components/etic/page-header.js.map +1 -1
- package/dist/components/etic/removable-badge.js +26 -18
- package/dist/components/etic/removable-badge.js.map +1 -1
- package/dist/components/etic/save-bar.d.ts +4 -3
- package/dist/components/etic/save-bar.js +2 -2
- package/dist/components/etic/save-bar.js.map +1 -1
- package/dist/components/etic/stat-tile.d.ts +9 -2
- package/dist/components/etic/stat-tile.js +32 -18
- package/dist/components/etic/stat-tile.js.map +1 -1
- package/dist/components/etic/theme-menu.d.ts +28 -0
- package/dist/components/etic/theme-menu.js +62 -35
- package/dist/components/etic/theme-menu.js.map +1 -1
- package/dist/components/etic/toggletip.js +3 -3
- package/dist/components/etic/toggletip.js.map +1 -1
- package/dist/components/etic/tooltip-button.d.ts +7 -3
- package/dist/components/etic/tooltip-button.js +2 -2
- package/dist/components/etic/tooltip-button.js.map +1 -1
- package/dist/components/ui/button.js +2 -2
- package/dist/components/ui/button.js.map +1 -1
- package/dist/components/ui/select.js +3 -3
- package/dist/components/ui/select.js.map +1 -1
- package/dist/styles.css +107 -69
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -67,19 +67,33 @@ liens survolés) : c'est corrigé dans `src/components/ui/`, et `npm test` écho
|
|
|
67
67
|
|
|
68
68
|
Le thème sombre s'active par la classe `dark` sur `<html>`.
|
|
69
69
|
|
|
70
|
-
Les neutres (fonds, panneaux, bordures, textes) sont ceux de la couleur de base `
|
|
71
|
-
shadcn (palette `
|
|
72
|
-
application ne les redéfinit pas.
|
|
73
|
-
(
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
70
|
+
Les neutres (fonds, panneaux, bordures, textes) sont ceux de la couleur de base `zinc` de
|
|
71
|
+
shadcn (palette `zinc` de Tailwind 4, gris froid presque neutre), communs à toute la suite : une
|
|
72
|
+
application ne les redéfinit pas. Ce sont exactement les valeurs du preset, contraste faible
|
|
73
|
+
compris (texte secondaire zinc-500 : 4,39:1 sur `--muted` en clair), sauf les écarts décidés
|
|
74
|
+
pour ETIC : `--page`, barre latérale blanche en clair, `--control-border`, couleurs
|
|
75
|
+
sémantiques. `src/theme.test.ts` compare chaque jeton au registre et vérifie les contrastes.
|
|
76
|
+
|
|
77
|
+
Le fond de la page elle-même est un jeton ajouté, `--page` (classe `bg-page`) : zinc-50 en
|
|
78
|
+
clair, si bien que cartes et menus blancs s'en détachent (en sombre, il vaut
|
|
77
79
|
`--background` et les cartes sont déjà plus claires). Le `body` et le contenu d'`AppShell`
|
|
78
80
|
le prennent ; un conteneur pleine page d'une application aussi, plutôt que `bg-background`,
|
|
79
81
|
qui reste la surface blanche de shadcn (onglet actif, bouton `outline`, calendrier…).
|
|
80
82
|
`color-scheme` suit le thème (`light`, `dark`) : barres de défilement et contrôles natifs
|
|
81
83
|
compris.
|
|
82
84
|
|
|
85
|
+
Un tableau se détache de la surface qui le porte : son cadre est en `bg-tableau` (jeton
|
|
86
|
+
ajouté), qui vaut `--card` sur la page et `--tableau-encart` (jeton ajouté, un cran plus
|
|
87
|
+
sombre que la carte) dans une surface surélevée — toute surface de la bibliothèque peinte en `bg-card` ou `bg-popover` : `Card`
|
|
88
|
+
(donc `SectionCard`), `Alert`, dialogue, `AlertDialog`, tiroir (`Sheet`), popover, menu
|
|
89
|
+
déroulant, liste d'un `Select` ou d'un `Combobox`, `SaveBar`, barre d'actions groupées, barre
|
|
90
|
+
latérale, `Disclosure` `variante="carte"`. La liste de ces surfaces est tenue une fois dans
|
|
91
|
+
`styles.css` (règle qui pose `--tableau-fond`, héritée) ; le cadre de `DataTable` la suit sans
|
|
92
|
+
rien à passer. Un cadre de tableau propre à une application prend `bg-tableau` plutôt que
|
|
93
|
+
`bg-card`. Dans une surface, l'écart de fond est le même, discret, dans les deux thèmes (1,05:1,
|
|
94
|
+
le filet `--border` le rend net) : le tableau se détache de sa carte sans s'y creuser. Les lignes gardent le
|
|
95
|
+
survol et la sélection de shadcn (`bg-muted/50`, `bg-muted`).
|
|
96
|
+
|
|
83
97
|
#### Thème clair, sombre ou système
|
|
84
98
|
|
|
85
99
|
`appliquerTheme(theme)` pose la classe `dark` sur `<html>` pour `"dark"`, la retire pour
|
|
@@ -189,8 +203,11 @@ export function Groupes() {
|
|
|
189
203
|
}
|
|
190
204
|
```
|
|
191
205
|
|
|
192
|
-
|
|
193
|
-
|
|
206
|
+
Le thème est une entrée du menu du compte (« Thème : Sombre », qui ouvre Clair / Système /
|
|
207
|
+
Sombre), comme dans le `nav-user` de shadcn : le pied de la barre ne porte que le compte, sur
|
|
208
|
+
toute sa largeur. Dans le tiroir mobile, trop étroit pour un sous-menu, les trois choix sont
|
|
209
|
+
dans le menu. Sans `compte`, il garde son propre bouton. `onValeurChange` peut renvoyer une
|
|
210
|
+
promesse : rejetée, elle affiche « Thème non enregistré » quelques secondes. La déconnexion (`onSeDeconnecter`) est toujours confirmée ; une entrée du
|
|
194
211
|
menu du compte est un lien (`href`) ou une action (`onChoisir`). La coquille fournit l'élément
|
|
195
212
|
`<main>` : les pages n'en ajoutent pas. Elle ouvre la tabulation par un lien « Aller au
|
|
196
213
|
contenu », visible au focus, qui met le focus sur ce `<main>`. Sur ordinateur, un bouton de
|
|
@@ -227,32 +244,32 @@ Compositions des primitives shadcn pour les états d'une page et les actions cou
|
|
|
227
244
|
connaissent ni l'API ni le routeur : l'application fournit ses fonctions (envoi, suppression,
|
|
228
245
|
chargement d'une image) et, au besoin, son composant de lien (`lien`, comme pour `AppShell`).
|
|
229
246
|
|
|
230
|
-
| Composant | Rôle
|
|
231
|
-
| ------------------------------------------------------------------------ |
|
|
232
|
-
| `ConfirmDialog` | Confirmation (`AlertDialog`) : `titre` qui nomme l'action, `description` qui nomme ce qu'elle touche, `saisie` pour exiger de taper une valeur non affichée (action critique). L'erreur de l'action s'affiche dans le dialogue, qui reste ouvert.
|
|
233
|
-
| `FormDialog` | Formulaire dans un `Dialog` : pied « Annuler / Enregistrer », curseur dans le premier champ à remplir, état d'envoi (champs figés), erreur en tête, `taille` `sm` à `xl`, `verrouEnvoi` pour dire pourquoi l'envoi est impossible. Les contraintes des champs (`required`, `type`, `pattern`…) sont vérifiées sans la bulle du navigateur : la liste des champs à corriger s'affiche en français.
|
|
234
|
-
| `DraftResumeDialog` | Ouverture d'un utilitaire à brouillon (compagnon de `useDraftAutosave`) : « Quitter », `libelleRepartir` (suppression du brouillon, `onRepartir` attendue, bouton occupé, erreur affichée, comme `erreur` venue d'ailleurs) et « Reprendre au même point » si `reprenable`. Sans croix ; Échap quitte, jamais pendant la suppression.
|
|
235
|
-
| `UnsavedChangesDialog`, `useUnsavedChangesWarning` | Garde « modifications non enregistrées », sans routeur : `useUnsavedChangesWarning(modifie)` (booléen, ou fonction lue au moment de quitter) retient la fermeture de l'onglet ; le dialogue confirme une navigation retenue par l'application (`blocage` : `state`, `proceed`, `reset`, la forme du `useBlocker` de react-router).
|
|
236
|
-
| `PageContainer` | Conteneur de page dans `AppShell` : marges, `largeur` maximale, espacement entre les blocs.
|
|
237
|
-
| `PageHeader`, `DetailHeader` | En-tête de page (`<h1>`, description, actions) ; en-tête de fiche avec fil d'Ariane (`chemin`), badges, méta, actions et menu « Plus d'actions » (`actionsSecondaires` : `onChoisir`, `destructif`, `verrou` affiché sous le libellé
|
|
238
|
-
| `SectionCard`, `DetailList`, `DetailItem` | Carte de section titrée (`<h2>`) ; liste `<dl>` de paires libellé / valeur, « — » pour une valeur absente (`null`, `undefined`, `false`, chaîne vide). `disposition` : `grille` (défaut, autant de colonnes que la largeur en permet), `pile` (une seule colonne, libellé au-dessus de la valeur : carte étroite, dialogue, valeurs longues), `ligne` (métadonnées secondaires : « libellé : valeur » en petit et en discret, l'une après l'autre). |
|
|
239
|
-
| `ErrorBanner` | `Alert` destructive : message, code, détail technique replié (même circulaire), « Réessayer » (`onReessayer`, occupé pendant `enCours`). Lit toute erreur ayant un `message` (et `code`, `details`).
|
|
240
|
-
| `ErrorBoundary` | Filet sous le rendu : message, détail technique, « Réessayer », « Retour à l'accueil » ; `cleReinitialisation` (la route) l'efface. Le focus perdu avec la partie cassée passe sur le message.
|
|
241
|
-
| `EmptyState`, `Loading`, `SkeletonTable`, `SkeletonCard`, `SkeletonPage` | État vide (`Empty` dans un cadre pointillé, `icone` lucide : `icone={InboxIcon}`) ; attente annoncée (`Spinner`) ; squelettes de tableau, de carte et de fiche, un seul statut « Chargement… » chacun.
|
|
242
|
-
| `QueryBoundary` | Chargement, erreur (avec « Réessayer »), vide et données d'une requête ; accepte tel quel le résultat de `useQuery`. L'échec d'une actualisation garde les données, montées, sous le bandeau d'erreur ; pendant une nouvelle tentative, le bandeau reste, son bouton occupé. Sans enveloppe : rendu dans le parent, qui règle l'espacement.
|
|
243
|
-
| `QueryBoundary introuvable` | Fiche : `introuvable` (texte ou nœud, avec un lien de retour) remplace le bandeau quand l'erreur porte un `status` 404 (`ErreurApi` de `@etic-insa/auth`, ou même forme), sans « Réessayer ». Les autres échecs gardent le bandeau : une panne n'est jamais annoncée « introuvable ».
|
|
244
|
-
| `QueryErrorBanner` | Le bandeau d'erreur de `QueryBoundary`, seul (`requete` : `isError`, `error`, `isFetching`, `refetch`), pour une page qui place elle-même ses données ; rien tant que la requête n'a pas échoué. Accepte `titre`, `description`, `className` d'`ErrorBanner`.
|
|
245
|
-
| `Disclosure`, `DisclosureTrigger` | Section repliable à chevron tournant, fermée par défaut : `titre`, `compteur` en pastille, `variante` `lien` (en ligne), `discret` (fantôme estompé) ou `carte` (bloc encadré), `defautOuvert` ou `ouvert` / `onOuvertChange`. `DisclosureTrigger` seul pour un `Collapsible` composé à la main.
|
|
246
|
-
| `CenteredScreen` | Écran hors de la coquille (connexion, page introuvable, vérification de session) : le `<main>` de la page, contenu centré sur toute la hauteur, fond estompé.
|
|
247
|
-
| `StatTile`, `StatGrid`, `StatusBadge` | Chiffre clé d'un résumé ; rangée de tuiles (colonnes de `largeurMin` au moins, 190 px par défaut, une seule sur téléphone) ; badge d'état à pastille. `ton` (type `StatusTon`) : `neutral`, `info`, `success`, `warning`, `destructive` ; il colore aussi `Progress` (8 px avec `size="lg"`), le segment choisi d'un `SegmentedControl` et un `IconToggle` actif.
|
|
248
|
-
| `RemovableBadge`, `ExplainedBadge` | Badge de 28 px (`size="lg"`, aussi pour les badges sans croix de la même liste) terminé par une croix « Retirer » (`onRetirer`, `libelleRetirer`, `enCours`, `verrou`) ; badge dont l'`explication` s'ouvre au toucher, au clic, au survol et au focus (un `Toggletip`) et se lit après lui (`render` : un autre porteur, `<time>` par exemple).
|
|
249
|
-
| `Toggletip` | Explication d'un élément qui n'est pas une action (date, sigle) : bulle sur `Popover`, ouverte au toucher, au clic, au survol et au focus, fermée au toucher ailleurs, à Échap ou quand le focus part ; clic sans effet sur un parent cliquable ; lue après le contenu (`texteLu`). Un bouton qui agit garde son infobulle (`TooltipButton`).
|
|
250
|
-
| `SaveBar` | Pied d'un formulaire de page : « Enregistrer » (soumet le formulaire, ou `onEnregistrer`), occupé mais focalisable pendant `enCours` ; « Annuler » avec `onAnnuler` ; statut annoncé : « Enregistré » (`enregistre`), « Modifications non enregistrées » (`modifie`). `collante` :
|
|
251
|
-
| `CopyButton`, `DeleteButton`, `IconToggle` | Copie avec retour « Copié ! », ou « Copie impossible » si le navigateur refuse (`onCopie`, `onEchec`) ; corbeille qui ouvre une confirmation ; bouton à icône qui pose ou retire un marqueur (`Toggle`, `aria-pressed`, `onActifChange`, `enCours` occupé sans perdre le focus ; actif, en couleur de son `ton`, `warning` par défaut). Tous ont une infobulle, et `verrou` pour dire pourquoi l'action est impossible.
|
|
252
|
-
| `TooltipButton` | `Button` avec infobulle et état `verrou` (désactivé mais focalisable, la raison en infobulle) : la règle pour tout bouton à icône seule, que l'infobulle nomme (`aria-label`, sauf nom donné). `destructif` : gris, rouge au survol seulement (corbeille, retrait dans une liste).
|
|
253
|
-
| `ButtonLink` | Lien à l'allure de bouton (`variant`, `size` de `Button`), annoncé comme un lien ; `lien` : le composant de lien du routeur, par défaut celui du `LienProvider` (`<a>` sans lui ; `lien="a"` force un rechargement complet).
|
|
254
|
-
| `AuthAvatar`, `AuthImage`, `useAuthObjectUrl` | Image servie par une adresse authentifiée : l'application passe `charger(src, signal)` (type `AuthImageCharger`) qui renvoie le `Blob` ; l'avatar garde les initiales tant que la photo manque.
|
|
255
|
-
| `useAuthObjectUrlEtat`, `secoursEchec`, `diametre` | État complet d'une image authentifiée (`url`, `enCours`, `echec`, `erreur`) pour dire « indisponible » plutôt que charger sans fin ; `secoursEchec` d'`AuthImage` en cas d'échec ; `diametre` (px) d'`AuthAvatar` et d'`Avatar`, initiales proportionnées (leur graisse suit la racine).
|
|
247
|
+
| Composant | Rôle |
|
|
248
|
+
| ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
249
|
+
| `ConfirmDialog` | Confirmation (`AlertDialog`) : `titre` qui nomme l'action, `description` qui nomme ce qu'elle touche, `saisie` pour exiger de taper une valeur non affichée (action critique). L'erreur de l'action s'affiche dans le dialogue, qui reste ouvert. |
|
|
250
|
+
| `FormDialog` | Formulaire dans un `Dialog` : pied « Annuler / Enregistrer », curseur dans le premier champ à remplir, état d'envoi (champs figés), erreur en tête, `taille` `sm` à `xl`, `verrouEnvoi` pour dire pourquoi l'envoi est impossible. Les contraintes des champs (`required`, `type`, `pattern`…) sont vérifiées sans la bulle du navigateur : la liste des champs à corriger s'affiche en français. |
|
|
251
|
+
| `DraftResumeDialog` | Ouverture d'un utilitaire à brouillon (compagnon de `useDraftAutosave`) : « Quitter », `libelleRepartir` (suppression du brouillon, `onRepartir` attendue, bouton occupé, erreur affichée, comme `erreur` venue d'ailleurs) et « Reprendre au même point » si `reprenable`. Sans croix ; Échap quitte, jamais pendant la suppression. |
|
|
252
|
+
| `UnsavedChangesDialog`, `useUnsavedChangesWarning` | Garde « modifications non enregistrées », sans routeur : `useUnsavedChangesWarning(modifie)` (booléen, ou fonction lue au moment de quitter) retient la fermeture de l'onglet ; le dialogue confirme une navigation retenue par l'application (`blocage` : `state`, `proceed`, `reset`, la forme du `useBlocker` de react-router). |
|
|
253
|
+
| `PageContainer` | Conteneur de page dans `AppShell` : marges, `largeur` maximale, espacement entre les blocs. |
|
|
254
|
+
| `PageHeader`, `DetailHeader` | En-tête de page (`<h1>`, description, actions) ; en-tête de fiche avec fil d'Ariane (`chemin`), badges, méta, actions et menu « Plus d'actions » (`actionsSecondaires` : `onChoisir`, `destructif`, `verrou` affiché sous le libellé), `compact` quand la fiche répète déjà son nom. |
|
|
255
|
+
| `SectionCard`, `DetailList`, `DetailItem` | Carte de section titrée (`<h2>`) ; liste `<dl>` de paires libellé / valeur, « — » pour une valeur absente (`null`, `undefined`, `false`, chaîne vide). `disposition` : `grille` (défaut, autant de colonnes de 14rem que la largeur en permet, quatre au plus : une liste courte laisse de l'air à droite sans tenir dans un coin), `pile` (une seule colonne, libellé au-dessus de la valeur : carte étroite, dialogue, valeurs longues), `ligne` (métadonnées secondaires : « libellé : valeur » en petit et en discret, l'une après l'autre). |
|
|
256
|
+
| `ErrorBanner` | `Alert` destructive : message, code, détail technique replié (même circulaire), « Réessayer » (`onReessayer`, occupé pendant `enCours`). Lit toute erreur ayant un `message` (et `code`, `details`). |
|
|
257
|
+
| `ErrorBoundary` | Filet sous le rendu : message, détail technique, « Réessayer », « Retour à l'accueil » ; `cleReinitialisation` (la route) l'efface. Le focus perdu avec la partie cassée passe sur le message. |
|
|
258
|
+
| `EmptyState`, `Loading`, `SkeletonTable`, `SkeletonCard`, `SkeletonPage` | État vide (`Empty` dans un cadre pointillé, `icone` lucide : `icone={InboxIcon}`) ; attente annoncée (`Spinner`) ; squelettes de tableau, de carte et de fiche, un seul statut « Chargement… » chacun. |
|
|
259
|
+
| `QueryBoundary` | Chargement, erreur (avec « Réessayer »), vide et données d'une requête ; accepte tel quel le résultat de `useQuery`. L'échec d'une actualisation garde les données, montées, sous le bandeau d'erreur ; pendant une nouvelle tentative, le bandeau reste, son bouton occupé. Sans enveloppe : rendu dans le parent, qui règle l'espacement. |
|
|
260
|
+
| `QueryBoundary introuvable` | Fiche : `introuvable` (texte ou nœud, avec un lien de retour) remplace le bandeau quand l'erreur porte un `status` 404 (`ErreurApi` de `@etic-insa/auth`, ou même forme), sans « Réessayer ». Les autres échecs gardent le bandeau : une panne n'est jamais annoncée « introuvable ». |
|
|
261
|
+
| `QueryErrorBanner` | Le bandeau d'erreur de `QueryBoundary`, seul (`requete` : `isError`, `error`, `isFetching`, `refetch`), pour une page qui place elle-même ses données ; rien tant que la requête n'a pas échoué. Accepte `titre`, `description`, `className` d'`ErrorBanner`. |
|
|
262
|
+
| `Disclosure`, `DisclosureTrigger` | Section repliable à chevron tournant, fermée par défaut : `titre`, `compteur` en pastille, `variante` `lien` (en ligne), `discret` (fantôme estompé) ou `carte` (bloc encadré), `defautOuvert` ou `ouvert` / `onOuvertChange`. `DisclosureTrigger` seul pour un `Collapsible` composé à la main. |
|
|
263
|
+
| `CenteredScreen` | Écran hors de la coquille (connexion, page introuvable, vérification de session) : le `<main>` de la page, contenu centré sur toute la hauteur, fond estompé. |
|
|
264
|
+
| `StatTile`, `StatGrid`, `StatusBadge` | Chiffre clé d'un résumé (`href` : toute la tuile mène au détail, avec un chevron ; `lien` du routeur, ou celui du `LienProvider`) ; rangée de tuiles (colonnes de `largeurMin` au moins, 190 px par défaut, une seule sur téléphone) ; badge d'état à pastille. `ton` (type `StatusTon`) : `neutral`, `info`, `success`, `warning`, `destructive` ; il colore aussi `Progress` (8 px avec `size="lg"`), le segment choisi d'un `SegmentedControl` et un `IconToggle` actif. |
|
|
265
|
+
| `RemovableBadge`, `ExplainedBadge` | Badge de 28 px (`size="lg"`, aussi pour les badges sans croix de la même liste) terminé par une croix « Retirer » (`onRetirer`, `libelleRetirer`, `enCours`, `verrou`) ; seul le premier élément du libellé se coupe, un marqueur qui le suit (cadenas) reste entier et centré ; badge dont l'`explication` s'ouvre au toucher, au clic, au survol et au focus (un `Toggletip`) et se lit après lui (`render` : un autre porteur, `<time>` par exemple). |
|
|
266
|
+
| `Toggletip` | Explication d'un élément qui n'est pas une action (date, sigle) : bulle sur `Popover`, ouverte au toucher, au clic, au survol et au focus, fermée au toucher ailleurs, à Échap ou quand le focus part ; clic sans effet sur un parent cliquable ; lue après le contenu (`texteLu`) ; dans un badge, la bulle part de son contour. Un bouton qui agit garde son infobulle (`TooltipButton`). |
|
|
267
|
+
| `SaveBar` | Pied d'un formulaire de page : « Enregistrer » (soumet le formulaire, ou `onEnregistrer`), occupé mais focalisable pendant `enCours` ; « Annuler » avec `onAnnuler` ; statut annoncé : « Enregistré » (`enregistre`), « Modifications non enregistrées » (`modifie`). `collante` : pied d'un long formulaire, collé en bas de l'écran sur une carte opaque tant qu'il y a des modifications (`modifie`) ou un envoi en cours, à sa place et sans carte sinon. |
|
|
268
|
+
| `CopyButton`, `DeleteButton`, `IconToggle` | Copie avec retour « Copié ! », ou « Copie impossible » si le navigateur refuse (`onCopie`, `onEchec`) ; corbeille qui ouvre une confirmation ; bouton à icône qui pose ou retire un marqueur (`Toggle`, `aria-pressed`, `onActifChange`, `enCours` occupé sans perdre le focus ; actif, en couleur de son `ton`, `warning` par défaut). Tous ont une infobulle, et `verrou` pour dire pourquoi l'action est impossible. |
|
|
269
|
+
| `TooltipButton` | `Button` avec infobulle et état `verrou` (désactivé mais focalisable, la raison en infobulle) : la règle pour tout bouton à icône seule, que l'infobulle nomme (`aria-label`, sauf nom donné). `destructif` : gris, rouge au survol seulement (corbeille, retrait dans une liste). |
|
|
270
|
+
| `ButtonLink` | Lien à l'allure de bouton (`variant`, `size` de `Button`), annoncé comme un lien ; `lien` : le composant de lien du routeur, par défaut celui du `LienProvider` (`<a>` sans lui ; `lien="a"` force un rechargement complet). |
|
|
271
|
+
| `AuthAvatar`, `AuthImage`, `useAuthObjectUrl` | Image servie par une adresse authentifiée : l'application passe `charger(src, signal)` (type `AuthImageCharger`) qui renvoie le `Blob` ; l'avatar garde les initiales tant que la photo manque. |
|
|
272
|
+
| `useAuthObjectUrlEtat`, `secoursEchec`, `diametre` | État complet d'une image authentifiée (`url`, `enCours`, `echec`, `erreur`) pour dire « indisponible » plutôt que charger sans fin ; `secoursEchec` d'`AuthImage` en cas d'échec ; `diametre` (px) d'`AuthAvatar` et d'`Avatar`, initiales proportionnées (leur graisse suit la racine). |
|
|
256
273
|
|
|
257
274
|
`ConfirmDialog` et `FormDialog` s'ouvrent par un `declencheur`, ou sont contrôlés (`ouvert`,
|
|
258
275
|
`onOuvertChange`). `DeleteButton` est son propre déclencheur ; `ouvert` et `onOuvertChange`
|
|
@@ -435,6 +452,9 @@ obligatoire, invalide }`, ou `null` hors d'un `FormField`. `RequiredMark` existe
|
|
|
435
452
|
champ, loupe comprise (comme toute liste d'un `ComboboxInput`).
|
|
436
453
|
- `Select` (shadcn) : la liste s'ouvre sous le champ, alignée à gauche, sans jamais le
|
|
437
454
|
recouvrir (`alignItemWithTrigger` et `align` restent réglables sur `SelectContent`).
|
|
455
|
+
Elle prend la largeur de ses options, au moins celle du champ et au plus l'espace
|
|
456
|
+
disponible ; une option plus longue encore passe à la ligne au lieu d'être coupée. Dans le
|
|
457
|
+
champ, une valeur trop longue finit par « … ».
|
|
438
458
|
Les options vont dans un `SelectGroup`, comme chez shadcn ; posées directement dans
|
|
439
459
|
`SelectContent`, elles ont la même marge. Sans option (y compris un `SelectGroup` vide),
|
|
440
460
|
la liste dit « Aucune option. » (`vide` de `SelectContent`), dans une zone de statut
|
|
@@ -501,22 +521,22 @@ La famille `DataTable` suit le [guide Data Table de shadcn](https://ui.shadcn.co
|
|
|
501
521
|
sur [TanStack Table v9](https://tanstack.com/table/latest) : les colonnes se déclarent avec
|
|
502
522
|
l'assistant typé, `useDataTable` crée l'instance, les composants la reçoivent en `table`.
|
|
503
523
|
|
|
504
|
-
| Composant | Rôle
|
|
505
|
-
| -------------------------- |
|
|
506
|
-
| `useDataTable` | instance TanStack : tri, filtre et pagination (côté client, ou serveur avec `triManuel`), colonnes, sélection, dépliage
|
|
507
|
-
| `DataTable` | la Table de shadcn ; état vide, lignes fantômes du chargement, bandeau d'erreur (`requete`), clic de ligne, détail déplié
|
|
508
|
-
| `DataTableColumnHeader` | en-tête triable : un clic trie par ordre croissant, le suivant inverse le sens
|
|
509
|
-
| `dataTableSelectionColumn` | colonne de cases ; Maj+clic sélectionne une plage ; raison d'une case verrouillée
|
|
510
|
-
| `dataTableExpandColumn` | colonne du chevron qui déplie une ligne (`aria-expanded`, `aria-controls`)
|
|
511
|
-
| `dataTableActionsColumn` | colonne des commandes d'une ligne : en-tête lu mais invisible, commandes à droite
|
|
512
|
-
| `DataTableCellLink` | titre d'une ligne : vrai lien (`href`, routeur par `lien`) ou bouton
|
|
513
|
-
| `DataTableRowActions` | menu « … » d'une ligne
|
|
514
|
-
| `DataTableViewOptions` | bouton « Colonnes » : afficher, masquer, réordonner (glisser-déposer, clavier compris)
|
|
515
|
-
| `DataTableToolbar` | recherche, filtres (`DataTableSelectFilter`), compteur (`DataTableCount`), commandes
|
|
516
|
-
| `DataTablePagination` | pagination par décalage (offset/limit, total connu), ou celle du tableau (`table`)
|
|
517
|
-
| `DataTableBulkActions` | barre d'actions groupées, collante en bas, avec la sélection ; Échap
|
|
518
|
-
| `useColumnPrefs` | colonnes affichées et leur ordre, gardés dans le navigateur par liste et par personne
|
|
519
|
-
| `usePersistedState` | `useState` gardé dans le navigateur (filtre choisi…), sous la portée `PorteeStockageLocal`
|
|
524
|
+
| Composant | Rôle |
|
|
525
|
+
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
526
|
+
| `useDataTable` | instance TanStack : tri, filtre et pagination (côté client, ou serveur avec `triManuel`), colonnes, sélection, dépliage |
|
|
527
|
+
| `DataTable` | la Table de shadcn ; état vide, lignes fantômes du chargement, bandeau d'erreur (`requete`), clic de ligne, détail déplié |
|
|
528
|
+
| `DataTableColumnHeader` | en-tête triable : un clic trie par ordre croissant, le suivant inverse le sens |
|
|
529
|
+
| `dataTableSelectionColumn` | colonne de cases ; Maj+clic sélectionne une plage ; raison d'une case verrouillée |
|
|
530
|
+
| `dataTableExpandColumn` | colonne du chevron qui déplie une ligne (`aria-expanded`, `aria-controls`) |
|
|
531
|
+
| `dataTableActionsColumn` | colonne des commandes d'une ligne : en-tête lu mais invisible, commandes à droite |
|
|
532
|
+
| `DataTableCellLink` | titre d'une ligne : vrai lien (`href`, routeur par `lien`) ou bouton |
|
|
533
|
+
| `DataTableRowActions` | menu « … » d'une ligne |
|
|
534
|
+
| `DataTableViewOptions` | bouton « Colonnes » : afficher, masquer, réordonner (glisser-déposer, clavier compris) |
|
|
535
|
+
| `DataTableToolbar` | recherche, filtres (`DataTableSelectFilter`), compteur (`DataTableCount`), commandes |
|
|
536
|
+
| `DataTablePagination` | pagination par décalage (offset/limit, total connu), ou celle du tableau (`table`) |
|
|
537
|
+
| `DataTableBulkActions` | barre d'actions groupées, collante en bas, avec la sélection ; actions moins fréquentes dans « … » (`actionsSecondaires`) ; croix et Échap désélectionnent |
|
|
538
|
+
| `useColumnPrefs` | colonnes affichées et leur ordre, gardés dans le navigateur par liste et par personne |
|
|
539
|
+
| `usePersistedState` | `useState` gardé dans le navigateur (filtre choisi…), sous la portée `PorteeStockageLocal` |
|
|
520
540
|
|
|
521
541
|
```tsx
|
|
522
542
|
import { keepPreviousData, useQuery } from "@tanstack/react-query"
|
|
@@ -631,8 +651,8 @@ recherche. Quand une ligne qui avait le focus disparaît (suppression par un `De
|
|
|
631
651
|
menu « … » ou un dialogue de l'application ouvert depuis elle, liste rechargée), `DataTable`
|
|
632
652
|
rend le focus à la même cellule de la ligne suivante (ou précédente), sinon au tableau ; pour un
|
|
633
653
|
tableau rendu à la main, `focaliserTableau(cadre)` donne la même cible. `size` règle la taille
|
|
634
|
-
du `DeleteButton` (`icon-lg
|
|
635
|
-
|
|
654
|
+
du `DeleteButton` (`icon-lg` pour la corbeille dans un en-tête de page ; avec `avecTexte`,
|
|
655
|
+
l'en-tête l'agrandit seul). La recherche de `DataTableToolbar` porte `NO_AUTOFILL` ;
|
|
636
656
|
`recherche.attributs` lui ajoute des attributs.
|
|
637
657
|
|
|
638
658
|
L'en-tête du tableau ne se surligne pas au survol (seules les lignes de données le font). Quand
|
|
@@ -669,15 +689,19 @@ const supprimer = () =>
|
|
|
669
689
|
: api.supprimer(table.getSelectedRowIds())
|
|
670
690
|
```
|
|
671
691
|
|
|
672
|
-
|
|
673
|
-
|
|
674
|
-
|
|
675
|
-
|
|
676
|
-
|
|
677
|
-
|
|
678
|
-
|
|
679
|
-
|
|
680
|
-
|
|
692
|
+
Avec `total`, le compte de `DataTableBulkActions` situe la sélection (« 25 éléments sur 137
|
|
693
|
+
sélectionnés »). Quand toute la page est cochée et que `total` compte d'autres éléments, son menu
|
|
694
|
+
« … » propose « Sélectionner les 137 éléments », au-dessus de ses `actionsSecondaires` : dans la
|
|
695
|
+
barre, qui flotte, rien n'est inséré au-dessus des lignes et le tableau ne bouge pas. Une fois
|
|
696
|
+
accepté, la barre compte le total (« 137 éléments sélectionnés ») ; si « … » n'a plus rien à
|
|
697
|
+
proposer, il disparaît et le focus passe à « Tout désélectionner » ; `DataTable` l'annonce (« Les
|
|
698
|
+
137 éléments sont sélectionnés », accordé par ses `unite` et `feminin`). **Sans
|
|
699
|
+
`DataTableBulkActions`, rien ne propose de tout sélectionner.**
|
|
700
|
+
|
|
701
|
+
L'état repasse à `false` dès qu'une ligne de la page n'est plus cochée (par le tableau ou par
|
|
702
|
+
l'application), quand la page change (même avec `conserverSelection`) et par « Tout
|
|
703
|
+
désélectionner » (`table.options.meta.toutDeselectionner()` pour un bouton de l'application) ;
|
|
704
|
+
l'application le remet à `false` quand ses filtres ou le tri changent.
|
|
681
705
|
|
|
682
706
|
Une ligne non sélectionnable avec `verrouLigne` garde une case focalisable, en lecture seule, qui
|
|
683
707
|
dit sa raison (infobulle et description). Échap vide la sélection quand le focus est dans le
|
|
@@ -691,8 +715,9 @@ Sur le modèle de TanStack (`rowExpandingFeature`) et des exemples shadcn : `dat
|
|
|
691
715
|
ajoute le chevron (bouton à icône seule, infobulle, `aria-expanded`, `aria-controls`), et
|
|
692
716
|
`rendreDetail` de `DataTable` rend le détail sous la ligne, sur toute la largeur. Sans
|
|
693
717
|
`onActiverLigne`, un clic sur la ligne la déplie aussi ; la sélection et les commandes de la
|
|
694
|
-
ligne restent indépendantes.
|
|
695
|
-
|
|
718
|
+
ligne restent indépendantes. La ligne dépliée et son détail forment un seul bloc : même fond
|
|
719
|
+
(celui de la sélection si la ligne est cochée), sans filet entre eux. Sur mobile, le détail suit
|
|
720
|
+
la largeur visible du cadre : il reste lisible pendant que les colonnes défilent.
|
|
696
721
|
|
|
697
722
|
```tsx
|
|
698
723
|
const colonnes = aide.columns([
|
|
@@ -763,6 +788,9 @@ const colonnes = aide.columns([
|
|
|
763
788
|
dataTableActionsColumn<Poste>({
|
|
764
789
|
actions: (p) => <DeleteButton libelle={`le poste ${p.nom}`} … />,
|
|
765
790
|
// enableHiding: true pour une colonne d'actions masquable et déplaçable.
|
|
791
|
+
// Commandes sur la ligne survolée seulement (focus dans la ligne, menu
|
|
792
|
+
// ouvert et écran tactile compris), déjà en couleur (corbeille rouge) ;
|
|
793
|
+
// toujoursVisibles: true sur toutes.
|
|
766
794
|
}),
|
|
767
795
|
])
|
|
768
796
|
|
|
@@ -937,8 +965,7 @@ npm run build # dist/ : un module par composant, types, styles.css
|
|
|
937
965
|
react-day-picker (mois, jours et libellés d'accessibilité) et `weekStartsOn={1}` ;
|
|
938
966
|
- jours du calendrier de 36 px sous le seuil mobile (cible tactile), 28 px au-delà comme
|
|
939
967
|
dans shadcn : `--cell-size` de `calendar.tsx` ;
|
|
940
|
-
- thème (`styles.css`) : `--
|
|
941
|
-
initiales d'`Avatar`, `Kbd`), `--destructive` plus foncé en clair et plus clair en sombre
|
|
968
|
+
- thème (`styles.css`) : `--destructive` plus foncé en clair et plus clair en sombre
|
|
942
969
|
(≥ 4,5:1 sur sa teinte : bouton et badge `destructive`, y compris dans un pied de
|
|
943
970
|
dialogue) ; contrastes vérifiés par `src/theme.test.ts` ;
|
|
944
971
|
- l'accent comme texte en `text-primary-text` au lieu de `text-primary` : variante `link` de
|
|
@@ -949,6 +976,13 @@ npm run build # dist/ : un module par composant, types, styles.css
|
|
|
949
976
|
enfoncement au clic ; pas de `pointer-events-none`, qui couperait l'infobulle de sa raison ;
|
|
950
977
|
- `button.tsx` : taille `inline` (`h-auto min-h-6 gap-1 px-0`), pour un lien `variant="link"`
|
|
951
978
|
dans une phrase ou une cellule, cible tactile de 24 px gardée ;
|
|
979
|
+
- `button.tsx` : échelle d'une zone ; les tailles `default` et `icon` lisent leur hauteur
|
|
980
|
+
dans `--bouton-hauteur` et `--bouton-icone` (32 px sans elles, comme `h-8` et `size-8`).
|
|
981
|
+
`PageHeader` et `DetailHeader` les posent sur leurs actions (`tailleActions`, `lg` par
|
|
982
|
+
défaut : 36 px) : tous les boutons d'un en-tête ont la même hauteur sans `size` à chacun,
|
|
983
|
+
`ButtonLink` et tout `buttonVariants` compris. Une hauteur donnée par `className` l'emporte
|
|
984
|
+
(bouton d'un `InputGroup`) ; un dialogue ouvert depuis l'en-tête (rendu dans un portail)
|
|
985
|
+
garde ses tailles ;
|
|
952
986
|
- `button.tsx` : `enCours` (roue muette à la place des icônes, `aria-busy`, `data-en-cours`,
|
|
953
987
|
pas de survol, clics ignorés, focus gardé par `focusableWhenDisabled`) et `libelleEnCours` ;
|
|
954
988
|
un `children` n'est passé que s'il est donné (les enfants d'un `render` restent) ; `spinner.tsx` :
|
|
@@ -1048,20 +1082,23 @@ overflow-y-auto`), en-tête, croix et pied restant visibles ; sans elle, tout le
|
|
|
1048
1082
|
|
|
1049
1083
|
Le thème ajoute aussi (`styles.css`, hors composants shadcn) la règle de mouvement réduit.
|
|
1050
1084
|
|
|
1051
|
-
Thème : couleur de base `
|
|
1052
|
-
de `neutral` ; jeton ajouté `--page` (`bg-page`,
|
|
1085
|
+
Thème : couleur de base `zinc` de shadcn (registre `colors/zinc.json`, `cssVarsV4`) au lieu
|
|
1086
|
+
de `neutral` ; jeton ajouté `--page` (`bg-page`, zinc-50 en clair, `--background` en
|
|
1053
1087
|
sombre), pris par le `body` au lieu de `bg-background`, `--background` restant celui du
|
|
1054
1088
|
registre ; `--success` clair un cran plus foncé (≥ 4,5:1 sur sa teinte posée sur la page
|
|
1055
|
-
|
|
1056
|
-
|
|
1089
|
+
zinc-50) ; `--muted-foreground` celui du preset (zinc-500, 4,39:1 sur `--muted` en clair :
|
|
1090
|
+
contraste faible accepté) ; `--control-border`
|
|
1057
1091
|
(`--muted-foreground` à 80 %) en sombre aussi, au lieu de `--input` (sous 2:1) ; `--sidebar`
|
|
1058
|
-
clair = `--background` (barre latérale blanche, au lieu du
|
|
1092
|
+
clair = `--background` (barre latérale blanche, au lieu du zinc-50 du registre) ;
|
|
1059
1093
|
`color-scheme` dans `:root` et `.dark`. Les valeurs sont commentées dans `styles.css` ;
|
|
1060
1094
|
`theme.test.ts` compare chaque jeton au registre, écarts (`ECARTS`) exceptés, et en vérifie
|
|
1061
1095
|
les contrastes. Hors `ui/` : `CenteredScreen` est posé sur `bg-muted/40` au lieu du
|
|
1062
1096
|
`bg-muted` des blocs de connexion de shadcn (fond moins appuyé, en sombre surtout) ; le
|
|
1063
|
-
contenu d'`AppShell` (`SidebarInset`) et sa barre mobile sont en `bg-page` ;
|
|
1064
|
-
`
|
|
1097
|
+
contenu d'`AppShell` (`SidebarInset`) et sa barre mobile sont en `bg-page` ; la
|
|
1098
|
+
`Disclosure` `carte` est en `bg-card`, blanche comme une carte ; le cadre de `DataTable` est
|
|
1099
|
+
en `bg-tableau` (jeton ajouté) : `--card` sur la page, `--page` dans une carte, un dialogue,
|
|
1100
|
+
un tiroir, un popover ou une `Disclosure` `carte` (règle `--tableau-fond` de `styles.css`),
|
|
1101
|
+
pour se détacher toujours de son support.
|
|
1065
1102
|
|
|
1066
1103
|
Sans écart de code mais garanti par le même test : `Button` sans `type` rend
|
|
1067
1104
|
`type="button"` (Base UI le fait pour un bouton natif) et ne soumet donc pas son formulaire.
|
|
@@ -46,13 +46,16 @@ export interface AppShellProps {
|
|
|
46
46
|
application: {
|
|
47
47
|
nom: string;
|
|
48
48
|
sousTitre?: string;
|
|
49
|
-
/** Image ou icône,
|
|
49
|
+
/** Image ou icône, carrée : 32 px dans la barre latérale, 24 px dans la
|
|
50
|
+
* barre du haut sur mobile. */
|
|
50
51
|
logo?: ReactNode;
|
|
51
52
|
/** Lien de la marque ; « / » par défaut. */
|
|
52
53
|
href?: string;
|
|
53
54
|
};
|
|
54
55
|
sections: AppShellSection[];
|
|
55
56
|
compte?: AppShellCompte;
|
|
57
|
+
/** Choix du thème : entrée « Thème » du menu du compte, ou son propre
|
|
58
|
+
* bouton dans le pied de la barre sans `compte`. */
|
|
56
59
|
theme?: Pick<ThemeMenuProps, "valeur" | "onValeurChange">;
|
|
57
60
|
/** Composant de lien du routeur ; par défaut, celui du `LienProvider`,
|
|
58
61
|
* sinon un `<a>`. */
|