@etic-insa/ui 0.4.1 → 0.5.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 +109 -51
- package/dist/components/etic/centered-screen.d.ts +19 -1
- package/dist/components/etic/centered-screen.js +35 -3
- package/dist/components/etic/centered-screen.js.map +1 -1
- package/dist/components/etic/data-table-toolbar.d.ts +6 -4
- package/dist/components/etic/data-table-toolbar.js +2 -2
- package/dist/components/etic/data-table-toolbar.js.map +1 -1
- package/dist/components/etic/data-table.d.ts +3 -1
- package/dist/components/etic/data-table.js.map +1 -1
- package/dist/components/etic/dropdown-menu-action.d.ts +30 -0
- package/dist/components/etic/dropdown-menu-action.js +30 -0
- package/dist/components/etic/dropdown-menu-action.js.map +1 -0
- package/dist/components/etic/error-banner.d.ts +44 -10
- package/dist/components/etic/error-banner.js +43 -27
- package/dist/components/etic/error-banner.js.map +1 -1
- package/dist/components/etic/form-dialog.d.ts +8 -1
- package/dist/components/etic/form-dialog.js +92 -60
- package/dist/components/etic/form-dialog.js.map +1 -1
- package/dist/components/etic/page-header.d.ts +2 -1
- package/dist/components/etic/page-header.js +40 -52
- package/dist/components/etic/page-header.js.map +1 -1
- package/dist/components/etic/save-bar.d.ts +11 -5
- package/dist/components/etic/save-bar.js +15 -14
- package/dist/components/etic/save-bar.js.map +1 -1
- package/dist/components/ui/sheet.js +41 -36
- package/dist/components/ui/sheet.js.map +1 -1
- package/dist/index.d.ts +3 -2
- package/dist/index.js +46 -45
- package/dist/styles.css +7 -3
- package/dist/testing/index.d.ts +19 -0
- package/dist/testing/index.js +40 -0
- package/dist/testing/index.js.map +1 -0
- package/package.json +19 -3
- package/vite-plugin.d.ts +31 -0
- package/vite-plugin.js +156 -0
package/README.md
CHANGED
|
@@ -84,7 +84,7 @@ compris.
|
|
|
84
84
|
|
|
85
85
|
Un tableau se détache de la surface qui le porte : son cadre est en `bg-tableau` (jeton
|
|
86
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`
|
|
87
|
+
sombre que la carte en clair, plus clair en sombre) dans une surface surélevée — toute surface de la bibliothèque peinte en `bg-card` ou `bg-popover` : `Card`
|
|
88
88
|
(donc `SectionCard`), `Alert`, dialogue, `AlertDialog`, tiroir (`Sheet`), popover, menu
|
|
89
89
|
déroulant, liste d'un `Select` ou d'un `Combobox`, `SaveBar`, barre d'actions groupées, barre
|
|
90
90
|
latérale, `Disclosure` `variante="carte"`. La liste de ces surfaces est tenue une fois dans
|
|
@@ -244,32 +244,32 @@ Compositions des primitives shadcn pour les états d'une page et les actions cou
|
|
|
244
244
|
connaissent ni l'API ni le routeur : l'application fournit ses fonctions (envoi, suppression,
|
|
245
245
|
chargement d'une image) et, au besoin, son composant de lien (`lien`, comme pour `AppShell`).
|
|
246
246
|
|
|
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
|
|
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`
|
|
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
|
|
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).
|
|
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é, l'entrée `DropdownMenuAction` des autres menus), `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`) ; voir `ErrorBannerProvider` pour masquer le code. |
|
|
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`, `MessageScreen` | É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é ; écran qui ne dit qu'une chose (page introuvable, lien expiré) : `icone` en pastille, `titre` (`<h1>`), `description`, `actions`. |
|
|
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, sur une carte opaque alignée sur celles de la page, collé en bas de l'écran tant qu'il y a des modifications (`modifie`) ou un envoi en cours, à sa place sinon ; `masqueeAuRepos` ne l'affiche qu'avec quelque chose à dire. Les deux boutons ne se séparent jamais : au téléphone, le statut passe à la ligne ou se replie. |
|
|
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). |
|
|
273
273
|
|
|
274
274
|
`ConfirmDialog` et `FormDialog` s'ouvrent par un `declencheur`, ou sont contrôlés (`ouvert`,
|
|
275
275
|
`onOuvertChange`). `DeleteButton` est son propre déclencheur ; `ouvert` et `onOuvertChange`
|
|
@@ -306,7 +306,11 @@ dialogue : pas de `key` à forcer. `FormDialog` prend `libelleAnnuler` (« Plus
|
|
|
306
306
|
tête du pied (« Se déconnecter »), indisponible pendant l'envoi, qui ne ferme pas le dialogue
|
|
307
307
|
d'elle-même ; si `onChoisir` renvoie une promesse, le dialogue l'attend comme un envoi (ce
|
|
308
308
|
bouton en cours, le reste figé, erreur en tête), et `destructif` la rend grise, rouge au
|
|
309
|
-
survol (comme `TooltipButton`).
|
|
309
|
+
survol (comme `TooltipButton`). `modifie` (la saisie diffère de l'état initial) garde
|
|
310
|
+
`FormDialog` d'une perte : Échap, clic sur le voile, croix ou « Annuler » posent d'abord, en
|
|
311
|
+
tête du formulaire, « Abandonner la saisie ? » (« Continuer la saisie », qui reçoit le focus, ou
|
|
312
|
+
« Abandonner ») au lieu d'ouvrir un second dialogue ; un envoi réussi ferme sans rien demander.
|
|
313
|
+
Les boutons occupés de ces dialogues, de « Réessayer »
|
|
310
314
|
(`ErrorBanner`), de `FileUploadButton` et d'`IconToggle` sont tous le `Button` en cours. Sans champ où l'on tape, il s'ouvre sur le premier contrôle actif et affiché (case,
|
|
311
315
|
liste, choix segmenté… ; un panneau replié est ignoré). Tous les dialogues plafonnent leur
|
|
312
316
|
hauteur à l'écran et gardent le focus : Tab et Maj+Tab en font le tour sans en sortir. Dans
|
|
@@ -362,6 +366,37 @@ const [conflit, setConflit] = useState(false)
|
|
|
362
366
|
</QueryBoundary>
|
|
363
367
|
```
|
|
364
368
|
|
|
369
|
+
#### Affichage des erreurs
|
|
370
|
+
|
|
371
|
+
Une application dont les codes d'erreur ne parlent qu'aux développeurs (`not_found`…) les
|
|
372
|
+
masque une fois, à la racine : tous les bandeaux de la bibliothèque suivent
|
|
373
|
+
`ErrorBannerProvider` (`ErrorBanner`, `QueryErrorBanner`, `QueryBoundary`, le bandeau de
|
|
374
|
+
`DataTable`, l'erreur de `ConfirmDialog`, de `FormDialog` et de `DraftResumeDialog`).
|
|
375
|
+
L'erreur elle-même n'est pas réécrite : un 404 reste « introuvable » pour `QueryBoundary`.
|
|
376
|
+
`decrire` remplace la lecture de l'erreur (`decrireErreur`, exportée : message, code,
|
|
377
|
+
détail) pour une règle propre à l'application ; une fonction définie au niveau du module.
|
|
378
|
+
|
|
379
|
+
```tsx
|
|
380
|
+
// Un détail à taire pour une famille d'erreurs.
|
|
381
|
+
const decrire = (erreur: unknown) => {
|
|
382
|
+
const lu = decrireErreur(erreur)
|
|
383
|
+
return estPanneExterne(erreur) ? { ...lu, detail: undefined } : lu
|
|
384
|
+
}
|
|
385
|
+
|
|
386
|
+
export function Racine() {
|
|
387
|
+
return (
|
|
388
|
+
<ErrorBannerProvider masquerCode decrire={decrire}>
|
|
389
|
+
<App />
|
|
390
|
+
</ErrorBannerProvider>
|
|
391
|
+
)
|
|
392
|
+
}
|
|
393
|
+
```
|
|
394
|
+
|
|
395
|
+
`BoutonReessayer` (« Réessayer » des bandeaux, `size` `sm` ou `default`) et `DetailTechnique`
|
|
396
|
+
(détail replié sous « Détails », `libelle` au besoin) servent aussi hors d'un bandeau. La
|
|
397
|
+
colonne du texte d'un bandeau est bornée : une chaîne sans espace (adresse, identifiant) se
|
|
398
|
+
coupe au lieu de passer sous « Réessayer ».
|
|
399
|
+
|
|
365
400
|
Primitives shadcn ajoutées pour ces usages : `Alert` a, en plus de `destructive`, les variantes
|
|
366
401
|
`warning`, `info` et `success` (couleur `--info` dans le thème, contrastes vérifiés) ; `info` et
|
|
367
402
|
`success`, messages d'état, portent `role="status"` (annoncés sans interrompre), les autres
|
|
@@ -531,6 +566,7 @@ l'assistant typé, `useDataTable` crée l'instance, les composants la reçoivent
|
|
|
531
566
|
| `dataTableActionsColumn` | colonne des commandes d'une ligne : en-tête lu mais invisible, commandes à droite |
|
|
532
567
|
| `DataTableCellLink` | titre d'une ligne : vrai lien (`href`, routeur par `lien`) ou bouton |
|
|
533
568
|
| `DataTableRowActions` | menu « … » d'une ligne |
|
|
569
|
+
| `DropdownMenuAction` | entrée d'un menu d'actions : `libelle`, `icone`, `destructif`, `description` ; `verrou` grise l'entrée et affiche sa raison sous le libellé |
|
|
534
570
|
| `DataTableViewOptions` | bouton « Colonnes » : afficher, masquer, réordonner (glisser-déposer, clavier compris) |
|
|
535
571
|
| `DataTableToolbar` | recherche, filtres (`DataTableSelectFilter`), compteur (`DataTableCount`), commandes |
|
|
536
572
|
| `DataTablePagination` | pagination par décalage (offset/limit, total connu), ou celle du tableau (`table`) |
|
|
@@ -641,7 +677,8 @@ autres) : une cellule qui affiche un autre état le lit elle-même (hook, contex
|
|
|
641
677
|
|
|
642
678
|
Accessibilité : le tri choisi, le chargement et « tous sélectionnés » sont annoncés par le
|
|
643
679
|
tableau ; `DataTableCount` est une zone de statut (le nouveau compte après une recherche ou un
|
|
644
|
-
filtre est annoncé)
|
|
680
|
+
filtre est annoncé), qui n'ajoute la tranche affichée (« · 26–50 affichées », `feminin`) que si
|
|
681
|
+
la liste tient sur plusieurs pages ; `DataTablePagination` annonce la page atteinte. Quand un contrôle disparaît
|
|
645
682
|
sous le focus (« Réinitialiser », la croix de la recherche, le bandeau ou la barre de sélection),
|
|
646
683
|
le focus passe à un élément stable (champ de recherche, premier filtre, case d'en-tête). Le clic
|
|
647
684
|
de ligne (`onActiverLigne`) est un raccourci à la souris : une cellule doit aussi offrir un lien
|
|
@@ -901,34 +938,51 @@ const visibles = postes.filter((p) => correspond(p.nom, p.pole?.nom))
|
|
|
901
938
|
<Input type="search" {...NO_AUTOFILL} />
|
|
902
939
|
```
|
|
903
940
|
|
|
941
|
+
### Tests des applications
|
|
942
|
+
|
|
943
|
+
`@etic-insa/ui/test` réunit des outils pour les tests (vitest) des applications ; une entrée à
|
|
944
|
+
part, qui n'entre pas dans leur bundle. `installMatchMedia()` remplace `window.matchMedia` par
|
|
945
|
+
une doublure pilotable (celui de jsdom n'existe pas, celui de happy-dom suit une fenêtre fixe de
|
|
946
|
+
1 024 px, donc mobile pour la bibliothèque) ; `setMobileViewport(true)` passe en affichage
|
|
947
|
+
mobile, dans un `act()` sur un composant déjà monté. Seule la requête de `useIsMobile` est
|
|
948
|
+
connue ; toute autre ne correspond pas.
|
|
949
|
+
|
|
950
|
+
```ts
|
|
951
|
+
// src/test/setup.ts de l'application
|
|
952
|
+
import { beforeEach } from "vitest"
|
|
953
|
+
import { installMatchMedia, setMobileViewport } from "@etic-insa/ui/test"
|
|
954
|
+
|
|
955
|
+
installMatchMedia()
|
|
956
|
+
beforeEach(() => setMobileViewport(false))
|
|
957
|
+
```
|
|
958
|
+
|
|
904
959
|
### Développer contre les sources locales
|
|
905
960
|
|
|
906
961
|
Pour voir une modification de la bibliothèque instantanément dans une application, sans publier,
|
|
907
|
-
avec le dépôt `etic-packages` cloné sur le même poste
|
|
962
|
+
avec le dépôt `etic-packages` cloné sur le même poste, le plugin Vite `@etic-insa/ui/vite`
|
|
963
|
+
sert ses sources à la place des paquets installés, en développement seulement (`vite`, jamais
|
|
964
|
+
le build ni vitest) :
|
|
908
965
|
|
|
909
966
|
```ts
|
|
910
|
-
// vite.config.ts de l'application
|
|
911
|
-
|
|
912
|
-
|
|
913
|
-
|
|
914
|
-
|
|
915
|
-
|
|
916
|
-
|
|
917
|
-
|
|
918
|
-
alias: {
|
|
919
|
-
"@etic-insa/ui": UI_SRC,
|
|
920
|
-
// les composants s'importent entre eux par « @etic-ui/… »
|
|
921
|
-
"@etic-ui": UI_SRC,
|
|
922
|
-
},
|
|
923
|
-
// une seule copie de React, même si etic-packages a ses propres node_modules
|
|
924
|
-
dedupe: ["react", "react-dom"],
|
|
925
|
-
}
|
|
926
|
-
: {},
|
|
927
|
-
}))
|
|
967
|
+
// vite.config.ts de l'application
|
|
968
|
+
import { eticPackagesSources } from "@etic-insa/ui/vite"
|
|
969
|
+
|
|
970
|
+
export default defineConfig({
|
|
971
|
+
// Avant tailwindcss() : la feuille qui importe @etic-insa/ui/styles.css reçoit le @source
|
|
972
|
+
// des sources.
|
|
973
|
+
plugins: [eticPackagesSources({ auth: true }), tailwindcss(), react()],
|
|
974
|
+
})
|
|
928
975
|
```
|
|
929
976
|
|
|
930
|
-
|
|
931
|
-
|
|
977
|
+
Les sources sont celles de `ETIC_UI_SOURCES` (chemin de `packages/ui/src`), sinon d'un
|
|
978
|
+
`etic-packages` à côté du dépôt de l'application (depuis un worktree aussi), et seulement si ce
|
|
979
|
+
checkout a ses `node_modules` (`npm ci` à sa racine) ; `ETIC_UI_SOURCES=npm` force les paquets
|
|
980
|
+
installés. Le plugin pose les alias (`@etic-insa/ui`, ses `/styles.css` et `/test`,
|
|
981
|
+
`@etic-ui/…` ; `@etic-insa/auth` avec `auth: true`), une seule copie de React (`dedupe` en
|
|
982
|
+
ajoute : `["@tanstack/react-query"]` pour que l'`AuthProvider` des sources voie le
|
|
983
|
+
`QueryClient` de l'application), l'accès du serveur au checkout, le `@source` de Tailwind, et
|
|
984
|
+
annonce au démarrage ce qu'il sert (branche, commit, modifications). Il n'emploie que Node et
|
|
985
|
+
Vite (`vite`, dépendance pair facultative).
|
|
932
986
|
|
|
933
987
|
## Développer la bibliothèque
|
|
934
988
|
|
|
@@ -1091,7 +1145,11 @@ overflow-y-auto`), en-tête, croix et pied restant visibles ; sans elle, tout le
|
|
|
1091
1145
|
`CLASSES_BULLE` et `CLASSES_FLECHE` (internes) portent l'allure de la bulle, partagée
|
|
1092
1146
|
avec `Toggletip` ;
|
|
1093
1147
|
- `popover.tsx` : `PopoverContent` accepte `anchor` (celui du `Positioner` de Base UI),
|
|
1094
|
-
pour un popover sans `PopoverTrigger` (`Toggletip`, ancré sur l'élément qu'il explique)
|
|
1148
|
+
pour un popover sans `PopoverTrigger` (`Toggletip`, ancré sur l'élément qu'il explique) ;
|
|
1149
|
+
- `sheet.tsx` : `SheetHeader` réserve à droite la place de la croix (`pr-12`) quand
|
|
1150
|
+
`SheetContent` l'affiche (`showCloseButton`, vrai par défaut), au lieu de laisser un long
|
|
1151
|
+
titre passer dessous ; `SheetContent` le lui dit par un contexte. Un `className` de
|
|
1152
|
+
l'application l'emporte.
|
|
1095
1153
|
|
|
1096
1154
|
Le thème ajoute aussi (`styles.css`, hors composants shadcn) la règle de mouvement réduit.
|
|
1097
1155
|
|
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
import { ComponentProps } from 'react';
|
|
1
|
+
import { ComponentProps, ReactNode } from 'react';
|
|
2
|
+
import { LucideIcon } from 'lucide-react';
|
|
2
3
|
export type CenteredScreenProps = ComponentProps<"main">;
|
|
3
4
|
/**
|
|
4
5
|
* Écran hors de la coquille (connexion, retour du fournisseur d'identité,
|
|
@@ -11,3 +12,20 @@ export type CenteredScreenProps = ComponentProps<"main">;
|
|
|
11
12
|
* dessus.
|
|
12
13
|
*/
|
|
13
14
|
export declare function CenteredScreen({ className, ...props }: CenteredScreenProps): import("react").JSX.Element;
|
|
15
|
+
export interface MessageScreenProps extends Omit<CenteredScreenProps, "children"> {
|
|
16
|
+
/** Titre de la page (`<h1>`) : « Page introuvable ». */
|
|
17
|
+
titre: ReactNode;
|
|
18
|
+
/** Phrase sous le titre : pourquoi, et ce que la personne peut faire. */
|
|
19
|
+
description?: ReactNode;
|
|
20
|
+
/** Icône lucide (le composant : `icone={SearchXIcon}`), dans sa pastille. */
|
|
21
|
+
icone?: LucideIcon;
|
|
22
|
+
/** Le geste suivant : un lien de retour, un bouton. */
|
|
23
|
+
actions?: ReactNode;
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Écran entier qui ne dit qu'une chose (page introuvable, lien incomplet ou
|
|
27
|
+
* expiré, accès refusé) : icône, titre, phrase et actions, centrés dans la
|
|
28
|
+
* fenêtre, sur un `CenteredScreen` (dont il relaie les attributs). Un seul
|
|
29
|
+
* gabarit pour que ces écrans se ressemblent d'une application à l'autre.
|
|
30
|
+
*/
|
|
31
|
+
export declare function MessageScreen({ titre, description, icone: Icone, actions, ...props }: MessageScreenProps): import("react").JSX.Element;
|
|
@@ -1,13 +1,45 @@
|
|
|
1
1
|
import { cn as e } from "cn";
|
|
2
|
-
import { jsx as t } from "react/jsx-runtime";
|
|
2
|
+
import { jsx as t, jsxs as n } from "react/jsx-runtime";
|
|
3
3
|
// src/components/etic/centered-screen.tsx
|
|
4
|
-
function
|
|
4
|
+
function r({ className: n, ...r }) {
|
|
5
5
|
return /* @__PURE__ */ t("main", {
|
|
6
6
|
"data-slot": "centered-screen",
|
|
7
7
|
className: e("flex min-h-svh w-full flex-col items-center justify-center gap-6 bg-muted/40 p-6 md:p-10", n),
|
|
8
8
|
...r
|
|
9
9
|
});
|
|
10
10
|
}
|
|
11
|
-
|
|
11
|
+
function i({ titre: e, description: i, icone: a, actions: o, ...s }) {
|
|
12
|
+
return /* @__PURE__ */ t(r, {
|
|
13
|
+
...s,
|
|
14
|
+
children: /* @__PURE__ */ n("div", {
|
|
15
|
+
"data-slot": "message-screen",
|
|
16
|
+
className: "flex max-w-md flex-col items-center gap-4 text-center",
|
|
17
|
+
children: [
|
|
18
|
+
a ? /* @__PURE__ */ t("div", {
|
|
19
|
+
className: "flex size-12 items-center justify-center rounded-full bg-muted text-muted-foreground",
|
|
20
|
+
children: /* @__PURE__ */ t(a, {
|
|
21
|
+
className: "size-6",
|
|
22
|
+
"aria-hidden": "true"
|
|
23
|
+
})
|
|
24
|
+
}) : null,
|
|
25
|
+
/* @__PURE__ */ n("div", {
|
|
26
|
+
className: "flex flex-col gap-2",
|
|
27
|
+
children: [/* @__PURE__ */ t("h1", {
|
|
28
|
+
className: "text-2xl font-semibold tracking-tight",
|
|
29
|
+
children: e
|
|
30
|
+
}), i ? /* @__PURE__ */ t("p", {
|
|
31
|
+
className: "text-sm text-muted-foreground",
|
|
32
|
+
children: i
|
|
33
|
+
}) : null]
|
|
34
|
+
}),
|
|
35
|
+
o ? /* @__PURE__ */ t("div", {
|
|
36
|
+
className: "flex flex-wrap justify-center gap-2",
|
|
37
|
+
children: o
|
|
38
|
+
}) : null
|
|
39
|
+
]
|
|
40
|
+
})
|
|
41
|
+
});
|
|
42
|
+
}
|
|
43
|
+
export { r as CenteredScreen, i as MessageScreen };
|
|
12
44
|
|
|
13
45
|
//# sourceMappingURL=centered-screen.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"centered-screen.js","names":["CenteredScreen","props","cn","className"],"sources":["../../../src/components/etic/centered-screen.tsx"],"sourcesContent":["import type { ComponentProps } from \"react\"\nimport { cn } from \"cn\"\n\nexport type CenteredScreenProps = ComponentProps<\"main\">\n\n/**\n * Écran hors de la coquille (connexion, retour du fournisseur d'identité,\n * page introuvable, vérification de la session) : le contenu centré dans\n * toute la hauteur, sur le fond estompé, comme les blocs de connexion de\n * shadcn. C'est le `<main>` de la page.\n *\n * Écart avec shadcn : `bg-muted/40` au lieu de `bg-muted`, un fond moins\n * appuyé, surtout en sombre où `--muted` est plus clair que la carte posée\n * dessus.\n */\nexport function CenteredScreen({ className, ...props }: CenteredScreenProps) {\n return (\n <main\n data-slot=\"centered-screen\"\n className={cn(\n \"flex min-h-svh w-full flex-col items-center justify-center gap-6 bg-muted/40 p-6 md:p-10\",\n className\n )}\n {...props}\n />\n )\n}\n"],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"centered-screen.js","names":["CenteredScreen","props","cn","className","MessageScreen","Icone","titre","description","actions"],"sources":["../../../src/components/etic/centered-screen.tsx"],"sourcesContent":["import type { ComponentProps, ReactNode } from \"react\"\nimport { cn } from \"cn\"\nimport type { LucideIcon } from \"lucide-react\"\n\nexport type CenteredScreenProps = ComponentProps<\"main\">\n\n/**\n * Écran hors de la coquille (connexion, retour du fournisseur d'identité,\n * page introuvable, vérification de la session) : le contenu centré dans\n * toute la hauteur, sur le fond estompé, comme les blocs de connexion de\n * shadcn. C'est le `<main>` de la page.\n *\n * Écart avec shadcn : `bg-muted/40` au lieu de `bg-muted`, un fond moins\n * appuyé, surtout en sombre où `--muted` est plus clair que la carte posée\n * dessus.\n */\nexport function CenteredScreen({ className, ...props }: CenteredScreenProps) {\n return (\n <main\n data-slot=\"centered-screen\"\n className={cn(\n \"flex min-h-svh w-full flex-col items-center justify-center gap-6 bg-muted/40 p-6 md:p-10\",\n className\n )}\n {...props}\n />\n )\n}\n\nexport interface MessageScreenProps extends Omit<\n CenteredScreenProps,\n \"children\"\n> {\n /** Titre de la page (`<h1>`) : « Page introuvable ». */\n titre: ReactNode\n /** Phrase sous le titre : pourquoi, et ce que la personne peut faire. */\n description?: ReactNode\n /** Icône lucide (le composant : `icone={SearchXIcon}`), dans sa pastille. */\n icone?: LucideIcon\n /** Le geste suivant : un lien de retour, un bouton. */\n actions?: ReactNode\n}\n\n/**\n * Écran entier qui ne dit qu'une chose (page introuvable, lien incomplet ou\n * expiré, accès refusé) : icône, titre, phrase et actions, centrés dans la\n * fenêtre, sur un `CenteredScreen` (dont il relaie les attributs). Un seul\n * gabarit pour que ces écrans se ressemblent d'une application à l'autre.\n */\nexport function MessageScreen({\n titre,\n description,\n icone: Icone,\n actions,\n ...props\n}: MessageScreenProps) {\n return (\n <CenteredScreen {...props}>\n <div\n data-slot=\"message-screen\"\n className=\"flex max-w-md flex-col items-center gap-4 text-center\"\n >\n {Icone ? (\n <div className=\"flex size-12 items-center justify-center rounded-full bg-muted text-muted-foreground\">\n <Icone className=\"size-6\" aria-hidden=\"true\" />\n </div>\n ) : null}\n <div className=\"flex flex-col gap-2\">\n <h1 className=\"text-2xl font-semibold tracking-tight\">{titre}</h1>\n {description ? (\n <p className=\"text-sm text-muted-foreground\">{description}</p>\n ) : null}\n </div>\n {actions ? (\n <div className=\"flex flex-wrap justify-center gap-2\">{actions}</div>\n ) : null}\n </div>\n </CenteredScreen>\n )\n}\n"],"mappings":";;;AAgBA,SAAgBA,EAAe,EAAE,cAAW,GAAGC,KAA8B;CAC3E,OACE,kBAAC,QAAD;EACE,aAAU;EACV,WAAWC,EACT,4FACAC,CACF;EACA,GAAIF;CACL,CAAA;AAEL;AAsBA,SAAgBG,EAAc,EAC5B,UACA,gBACA,OAAOC,GACP,YACA,GAAGJ,KACkB;CACrB,OACE,kBAACD,GAAD;EAAgB,GAAIC;EAClB,UAAA,kBAAC,OAAD;GACE,aAAU;GACV,WAAU;GAFZ,UAAA;IAIGI,IACC,kBAAC,OAAD;KAAK,WAAU;KACb,UAAA,kBAACA,GAAD;MAAO,WAAU;MAAS,eAAY;KAAQ,CAAA;IAC3C,CAAA,IACH;IACJ,kBAAC,OAAD;KAAK,WAAU;KAAf,UAAA,CACE,kBAAC,MAAD;MAAI,WAAU;MAAyC,UAAAC;KAAU,CAAA,GAChEC,IACC,kBAAC,KAAD;MAAG,WAAU;MAAiC,UAAAA;KAAe,CAAA,IAC3D,IACD;;IACJC,IACC,kBAAC,OAAD;KAAK,WAAU;KAAuC,UAAAA;IAAa,CAAA,IACjE;GACD;;CACS,CAAA;AAEpB"}
|
|
@@ -5,7 +5,7 @@ import { DataTableInstance } from './data-table';
|
|
|
5
5
|
interface DataTableCountCommun {
|
|
6
6
|
/** Nom des éléments. « élément », « éléments » par défaut. */
|
|
7
7
|
unite?: DataTableUnite;
|
|
8
|
-
/** Accorde « affichées » au féminin. */
|
|
8
|
+
/** Accorde « affichées » au féminin (« 26–50 affichées »). */
|
|
9
9
|
feminin?: boolean;
|
|
10
10
|
className?: string;
|
|
11
11
|
}
|
|
@@ -26,9 +26,11 @@ export interface DataTableCountTableProps<TData extends RowData = RowData> exten
|
|
|
26
26
|
}
|
|
27
27
|
export type DataTableCountProps<TData extends RowData = RowData> = DataTableCountNombresProps | DataTableCountTableProps<TData>;
|
|
28
28
|
/**
|
|
29
|
-
* Compteur d'une liste : « 128 éléments · 26–50 affichés ».
|
|
30
|
-
*
|
|
31
|
-
*
|
|
29
|
+
* Compteur d'une liste : « 128 éléments · 26–50 affichés ». La tranche
|
|
30
|
+
* affichée n'apparaît que si la liste tient sur plusieurs pages : quand
|
|
31
|
+
* tout est affiché, elle redirait le total (« 7 éléments » seul). C'est une
|
|
32
|
+
* zone de statut : après une recherche, un filtre ou un changement de page,
|
|
33
|
+
* le nouveau compte est annoncé sans déplacer le focus. Avec `table`, il lit
|
|
32
34
|
* les nombres de la pagination côté client.
|
|
33
35
|
*/
|
|
34
36
|
export declare function DataTableCount<TData extends RowData>(props: DataTableCountProps<TData>): import("react").JSX.Element;
|
|
@@ -14,7 +14,7 @@ import { jsx as E, jsxs as D } from "react/jsx-runtime";
|
|
|
14
14
|
import { ListFilterIcon as O, SearchIcon as k, XIcon as A } from "lucide-react";
|
|
15
15
|
// src/components/etic/data-table-toolbar.tsx
|
|
16
16
|
function j(e) {
|
|
17
|
-
let { unite: i = b, feminin: a = !1, className: o } = e, { total: s, decalage: c = 0, nombre: l } = e.table ? x(e.table) : e, u = c + 1, d = c + l;
|
|
17
|
+
let { unite: i = b, feminin: a = !1, className: o } = e, { total: s, decalage: c = 0, nombre: l } = e.table ? x(e.table) : e, u = c + 1, d = c + l, f = c === 0 && l >= s;
|
|
18
18
|
return /* @__PURE__ */ D("p", {
|
|
19
19
|
"data-slot": "data-table-count",
|
|
20
20
|
role: "status",
|
|
@@ -27,7 +27,7 @@ function j(e) {
|
|
|
27
27
|
}),
|
|
28
28
|
" ",
|
|
29
29
|
r(s, i),
|
|
30
|
-
l > 0 ? /* @__PURE__ */ D("span", {
|
|
30
|
+
l > 0 && !f ? /* @__PURE__ */ D("span", {
|
|
31
31
|
className: "tabular-nums",
|
|
32
32
|
children: [
|
|
33
33
|
" ",
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"data-table-toolbar.js","names":["DataTableCount","UNITE_PAR_DEFAUT","props","paginationDuTableau","debut","decalage","fin","nombre","cn","className","nombreFr","total","uniteAccordee","unite","participe","feminin","DataTableSelectFilter","items","useMemo","libelleTous","options","option","Select","valeur","onValeurChange","SelectTrigger","libelle","SelectValue","SelectContent","SelectItem","item","DataTableToolbar","replier","useIsMobile","filtres","filtresActifs","racineRef","useRef","rechercheRef","reinitialiser","onReinitialiser","recherche","InputGroup","InputGroupAddon","SearchIcon","InputGroupInput","NO_AUTOFILL","event","Tooltip","TooltipTrigger","InputGroupButton","XIcon","TooltipContent","Popover","PopoverTrigger","Button","ListFilterIcon","PopoverContent","compteur","children"],"sources":["../../../src/components/etic/data-table-toolbar.tsx"],"sourcesContent":["import { useMemo, useRef, type ComponentProps, type ReactNode } from \"react\"\nimport type { RowData } from \"@tanstack/react-table\"\nimport { cn } from \"cn\"\nimport { ListFilterIcon, SearchIcon, XIcon } from \"lucide-react\"\n\nimport { Button } from \"@etic-ui/components/ui/button\"\nimport {\n InputGroup,\n InputGroupAddon,\n InputGroupButton,\n InputGroupInput,\n} from \"@etic-ui/components/ui/input-group\"\nimport {\n Tooltip,\n TooltipContent,\n TooltipTrigger,\n} from \"@etic-ui/components/ui/tooltip\"\nimport {\n Popover,\n PopoverContent,\n PopoverTrigger,\n} from \"@etic-ui/components/ui/popover\"\nimport {\n Select,\n SelectContent,\n SelectItem,\n SelectTrigger,\n SelectValue,\n} from \"@etic-ui/components/ui/select\"\nimport { useIsMobile } from \"@etic-ui/hooks/use-mobile\"\nimport {\n UNITE_PAR_DEFAUT,\n nombreFr,\n participe,\n uniteAccordee,\n type DataTableUnite,\n} from \"@etic-ui/components/etic/data-table-format\"\nimport {\n paginationDuTableau,\n type DataTableInstance,\n} from \"@etic-ui/components/etic/data-table\"\nimport { NO_AUTOFILL } from \"@etic-ui/lib/autofill\"\n\ninterface DataTableCountCommun {\n /** Nom des éléments. « élément », « éléments » par défaut. */\n unite?: DataTableUnite\n /** Accorde « affichées » au féminin. */\n feminin?: boolean\n className?: string\n}\n\n/** Compteur aux nombres donnés par l'application (pagination côté serveur). */\nexport interface DataTableCountNombresProps extends DataTableCountCommun {\n table?: never\n /** Nombre total d'éléments, toutes pages comprises. */\n total: number\n /** Rang (à partir de 0) du premier élément affiché. 0 par défaut. */\n decalage?: number\n /** Nombre d'éléments affichés. */\n nombre: number\n}\n\n/** Compteur lu dans le tableau (pagination côté client de `useDataTable`) :\n * lignes filtrées, page courante. */\nexport interface DataTableCountTableProps<\n TData extends RowData = RowData,\n> extends DataTableCountCommun {\n table: DataTableInstance<TData>\n}\n\nexport type DataTableCountProps<TData extends RowData = RowData> =\n DataTableCountNombresProps | DataTableCountTableProps<TData>\n\n/**\n * Compteur d'une liste : « 128 éléments · 26–50 affichés ». C'est une zone\n * de statut : après une recherche, un filtre ou un changement de page, le\n * nouveau compte est annoncé sans déplacer le focus. Avec `table`, il lit\n * les nombres de la pagination côté client.\n */\nexport function DataTableCount<TData extends RowData>(\n props: DataTableCountProps<TData>\n) {\n const { unite = UNITE_PAR_DEFAUT, feminin = false, className } = props\n const {\n total,\n decalage = 0,\n nombre,\n } = props.table ? paginationDuTableau(props.table) : props\n const debut = decalage + 1\n const fin = decalage + nombre\n return (\n <p\n data-slot=\"data-table-count\"\n role=\"status\"\n aria-atomic=\"true\"\n className={cn(\n \"text-sm whitespace-nowrap text-muted-foreground\",\n className\n )}\n >\n <strong className=\"font-medium text-foreground tabular-nums\">\n {nombreFr(total)}\n </strong>{\" \"}\n {uniteAccordee(total, unite)}\n {nombre > 0 ? (\n <span className=\"tabular-nums\">\n {\" \"}\n ·{\" \"}\n {fin > debut\n ? `${nombreFr(debut)}–${nombreFr(fin)}`\n : nombreFr(debut)}{\" \"}\n {participe(\"affiché\", nombre, feminin)}\n </span>\n ) : null}\n </p>\n )\n}\n\nexport interface DataTableSelectFilterOption {\n valeur: string\n libelle: string\n}\n\nexport interface DataTableSelectFilterProps {\n /** Nom du filtre pour les lecteurs d'écran : « Filtrer par statut ». */\n libelle: string\n /** Valeur choisie ; `null` = pas de filtre. */\n valeur: string | null\n onValeurChange: (valeur: string | null) => void\n options: DataTableSelectFilterOption[]\n /** Entrée sans filtre : « Tous les statuts ». */\n libelleTous: string\n className?: string\n}\n\n/** Filtre d'une liste : un Select de shadcn dont la première entrée retire\n * le filtre. */\nexport function DataTableSelectFilter({\n libelle,\n valeur,\n onValeurChange,\n options,\n libelleTous,\n className,\n}: DataTableSelectFilterProps) {\n const items = useMemo(\n () => [\n { value: null, label: libelleTous },\n ...options.map((option) => ({\n value: option.valeur,\n label: option.libelle,\n })),\n ],\n [libelleTous, options]\n )\n return (\n <Select items={items} value={valeur} onValueChange={onValeurChange}>\n <SelectTrigger aria-label={libelle} className={className}>\n <SelectValue />\n </SelectTrigger>\n <SelectContent>\n {items.map((item) => (\n <SelectItem key={item.value ?? \"\"} value={item.value}>\n {item.label}\n </SelectItem>\n ))}\n </SelectContent>\n </Select>\n )\n}\n\n/** Attributs du champ de recherche que l'application peut ajouter. */\nexport type DataTableRechercheAttributs = Omit<\n ComponentProps<\"input\">,\n \"value\" | \"defaultValue\" | \"onChange\" | \"type\" | \"ref\"\n>\n\nexport interface DataTableToolbarProps<TData extends RowData = RowData> {\n /** Champ de recherche, contrôlé (l'application temporise sa requête). */\n recherche?: {\n valeur: string\n onValeurChange: (valeur: string) => void\n placeholder?: string\n /** Nom du champ. « Rechercher » par défaut. */\n libelle?: string\n /** Attributs ajoutés au champ (`name`, `data-*`…). Le champ porte déjà\n * `autoComplete=\"off\"` et les attributs qui écartent les gestionnaires\n * de mots de passe ; ils peuvent être remplacés ici. */\n attributs?: DataTableRechercheAttributs\n }\n /** Filtres : `DataTableSelectFilter`… */\n filtres?: ReactNode\n /**\n * Nombre de filtres actifs. Fourni, il replie les filtres derrière un\n * bouton « Filtres (n) » sur mobile, où ils s'empileraient sinon au-dessus\n * des résultats, et affiche « Réinitialiser » s'il y en a.\n */\n filtresActifs?: number\n /** Retire tous les filtres (bouton « Réinitialiser »). */\n onReinitialiser?: () => void\n /** Compteur « N éléments · a–b affichés » : ses nombres, ou `{ table }`\n * pour une pagination côté client. */\n compteur?: DataTableCountProps<TData>\n /** À droite : `DataTableViewOptions`, bouton d'ajout… */\n children?: ReactNode\n className?: string\n}\n\n/**\n * Barre d'outils au-dessus d'un tableau, sur le modèle de celle de shadcn :\n * recherche et filtres à gauche, compteur et commandes (colonnes…) à droite.\n */\nexport function DataTableToolbar<TData extends RowData = RowData>({\n recherche,\n filtres,\n filtresActifs,\n onReinitialiser,\n compteur,\n children,\n className,\n}: DataTableToolbarProps<TData>) {\n const mobile = useIsMobile()\n const replier = mobile && filtres != null && filtresActifs !== undefined\n const racineRef = useRef<HTMLDivElement>(null)\n const rechercheRef = useRef<HTMLInputElement>(null)\n\n // « Réinitialiser » disparaît avec les filtres : le focus passe d'abord au\n // champ de recherche, sinon au premier filtre (ou au bouton « Filtres »),\n // au lieu de tomber sur <body>.\n const reinitialiser = () => {\n racineRef.current\n ?.querySelector<HTMLElement>(\n 'input[type=\"search\"], [data-slot=\"popover-trigger\"], [data-slot=\"select-trigger\"]'\n )\n ?.focus()\n onReinitialiser?.()\n }\n\n return (\n <div\n ref={racineRef}\n data-slot=\"data-table-toolbar\"\n className={cn(\"flex flex-wrap items-center gap-2\", className)}\n >\n {recherche ? (\n <InputGroup className=\"w-full sm:w-64\">\n <InputGroupAddon>\n <SearchIcon />\n </InputGroupAddon>\n <InputGroupInput\n // Une recherche n'est jamais un identifiant : sans ces attributs,\n // les gestionnaires de mots de passe y proposent une adresse.\n {...NO_AUTOFILL}\n {...recherche.attributs}\n ref={rechercheRef}\n type=\"search\"\n aria-label={recherche.libelle ?? \"Rechercher\"}\n placeholder={recherche.placeholder ?? \"Rechercher…\"}\n value={recherche.valeur}\n onChange={(event) => recherche.onValeurChange(event.target.value)}\n // La croix native de Chrome (bleue, 14 px, absente de Firefox)\n // cède la place au bouton ci-dessous.\n className={cn(\n \"[&::-webkit-search-cancel-button]:appearance-none\",\n recherche.attributs?.className\n )}\n />\n {recherche.valeur ? (\n <InputGroupAddon align=\"inline-end\">\n <Tooltip>\n <TooltipTrigger\n render={\n <InputGroupButton\n size=\"icon-xs\"\n aria-label=\"Effacer la recherche\"\n onClick={() => {\n // Le bouton disparaît : le focus revient au champ.\n rechercheRef.current?.focus()\n recherche.onValeurChange(\"\")\n }}\n />\n }\n >\n <XIcon />\n </TooltipTrigger>\n <TooltipContent>Effacer la recherche</TooltipContent>\n </Tooltip>\n </InputGroupAddon>\n ) : null}\n </InputGroup>\n ) : null}\n {replier ? (\n <Popover>\n <PopoverTrigger render={<Button variant=\"outline\" />}>\n <ListFilterIcon data-icon=\"inline-start\" />\n Filtres{filtresActifs ? ` (${filtresActifs})` : \"\"}\n </PopoverTrigger>\n <PopoverContent\n align=\"start\"\n className=\"w-64 *:data-[slot=select-trigger]:w-full\"\n >\n {filtres}\n </PopoverContent>\n </Popover>\n ) : (\n filtres\n )}\n {filtresActifs && onReinitialiser ? (\n <Button variant=\"ghost\" onClick={reinitialiser}>\n Réinitialiser\n <XIcon data-icon=\"inline-end\" />\n </Button>\n ) : null}\n {compteur || children ? (\n <div className=\"ml-auto flex flex-wrap items-center gap-x-4 gap-y-2\">\n {compteur ? <DataTableCount {...compteur} /> : null}\n {children}\n </div>\n ) : null}\n </div>\n )\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"data-table-toolbar.js","names":["DataTableCount","UNITE_PAR_DEFAUT","props","paginationDuTableau","debut","decalage","fin","nombre","toutAffiche","total","cn","className","nombreFr","uniteAccordee","unite","participe","feminin","DataTableSelectFilter","items","useMemo","libelleTous","options","option","Select","valeur","onValeurChange","SelectTrigger","libelle","SelectValue","SelectContent","SelectItem","item","DataTableToolbar","replier","useIsMobile","filtres","filtresActifs","racineRef","useRef","rechercheRef","reinitialiser","onReinitialiser","recherche","InputGroup","InputGroupAddon","SearchIcon","InputGroupInput","NO_AUTOFILL","event","Tooltip","TooltipTrigger","InputGroupButton","XIcon","TooltipContent","Popover","PopoverTrigger","Button","ListFilterIcon","PopoverContent","compteur","children"],"sources":["../../../src/components/etic/data-table-toolbar.tsx"],"sourcesContent":["import { useMemo, useRef, type ComponentProps, type ReactNode } from \"react\"\nimport type { RowData } from \"@tanstack/react-table\"\nimport { cn } from \"cn\"\nimport { ListFilterIcon, SearchIcon, XIcon } from \"lucide-react\"\n\nimport { Button } from \"@etic-ui/components/ui/button\"\nimport {\n InputGroup,\n InputGroupAddon,\n InputGroupButton,\n InputGroupInput,\n} from \"@etic-ui/components/ui/input-group\"\nimport {\n Tooltip,\n TooltipContent,\n TooltipTrigger,\n} from \"@etic-ui/components/ui/tooltip\"\nimport {\n Popover,\n PopoverContent,\n PopoverTrigger,\n} from \"@etic-ui/components/ui/popover\"\nimport {\n Select,\n SelectContent,\n SelectItem,\n SelectTrigger,\n SelectValue,\n} from \"@etic-ui/components/ui/select\"\nimport { useIsMobile } from \"@etic-ui/hooks/use-mobile\"\nimport {\n UNITE_PAR_DEFAUT,\n nombreFr,\n participe,\n uniteAccordee,\n type DataTableUnite,\n} from \"@etic-ui/components/etic/data-table-format\"\nimport {\n paginationDuTableau,\n type DataTableInstance,\n} from \"@etic-ui/components/etic/data-table\"\nimport { NO_AUTOFILL } from \"@etic-ui/lib/autofill\"\n\ninterface DataTableCountCommun {\n /** Nom des éléments. « élément », « éléments » par défaut. */\n unite?: DataTableUnite\n /** Accorde « affichées » au féminin (« 26–50 affichées »). */\n feminin?: boolean\n className?: string\n}\n\n/** Compteur aux nombres donnés par l'application (pagination côté serveur). */\nexport interface DataTableCountNombresProps extends DataTableCountCommun {\n table?: never\n /** Nombre total d'éléments, toutes pages comprises. */\n total: number\n /** Rang (à partir de 0) du premier élément affiché. 0 par défaut. */\n decalage?: number\n /** Nombre d'éléments affichés. */\n nombre: number\n}\n\n/** Compteur lu dans le tableau (pagination côté client de `useDataTable`) :\n * lignes filtrées, page courante. */\nexport interface DataTableCountTableProps<\n TData extends RowData = RowData,\n> extends DataTableCountCommun {\n table: DataTableInstance<TData>\n}\n\nexport type DataTableCountProps<TData extends RowData = RowData> =\n DataTableCountNombresProps | DataTableCountTableProps<TData>\n\n/**\n * Compteur d'une liste : « 128 éléments · 26–50 affichés ». La tranche\n * affichée n'apparaît que si la liste tient sur plusieurs pages : quand\n * tout est affiché, elle redirait le total (« 7 éléments » seul). C'est une\n * zone de statut : après une recherche, un filtre ou un changement de page,\n * le nouveau compte est annoncé sans déplacer le focus. Avec `table`, il lit\n * les nombres de la pagination côté client.\n */\nexport function DataTableCount<TData extends RowData>(\n props: DataTableCountProps<TData>\n) {\n const { unite = UNITE_PAR_DEFAUT, feminin = false, className } = props\n const {\n total,\n decalage = 0,\n nombre,\n } = props.table ? paginationDuTableau(props.table) : props\n const debut = decalage + 1\n const fin = decalage + nombre\n const toutAffiche = decalage === 0 && nombre >= total\n return (\n <p\n data-slot=\"data-table-count\"\n role=\"status\"\n aria-atomic=\"true\"\n className={cn(\n \"text-sm whitespace-nowrap text-muted-foreground\",\n className\n )}\n >\n <strong className=\"font-medium text-foreground tabular-nums\">\n {nombreFr(total)}\n </strong>{\" \"}\n {uniteAccordee(total, unite)}\n {nombre > 0 && !toutAffiche ? (\n <span className=\"tabular-nums\">\n {\" \"}\n ·{\" \"}\n {fin > debut\n ? `${nombreFr(debut)}–${nombreFr(fin)}`\n : nombreFr(debut)}{\" \"}\n {participe(\"affiché\", nombre, feminin)}\n </span>\n ) : null}\n </p>\n )\n}\n\nexport interface DataTableSelectFilterOption {\n valeur: string\n libelle: string\n}\n\nexport interface DataTableSelectFilterProps {\n /** Nom du filtre pour les lecteurs d'écran : « Filtrer par statut ». */\n libelle: string\n /** Valeur choisie ; `null` = pas de filtre. */\n valeur: string | null\n onValeurChange: (valeur: string | null) => void\n options: DataTableSelectFilterOption[]\n /** Entrée sans filtre : « Tous les statuts ». */\n libelleTous: string\n className?: string\n}\n\n/** Filtre d'une liste : un Select de shadcn dont la première entrée retire\n * le filtre. */\nexport function DataTableSelectFilter({\n libelle,\n valeur,\n onValeurChange,\n options,\n libelleTous,\n className,\n}: DataTableSelectFilterProps) {\n const items = useMemo(\n () => [\n { value: null, label: libelleTous },\n ...options.map((option) => ({\n value: option.valeur,\n label: option.libelle,\n })),\n ],\n [libelleTous, options]\n )\n return (\n <Select items={items} value={valeur} onValueChange={onValeurChange}>\n <SelectTrigger aria-label={libelle} className={className}>\n <SelectValue />\n </SelectTrigger>\n <SelectContent>\n {items.map((item) => (\n <SelectItem key={item.value ?? \"\"} value={item.value}>\n {item.label}\n </SelectItem>\n ))}\n </SelectContent>\n </Select>\n )\n}\n\n/** Attributs du champ de recherche que l'application peut ajouter. */\nexport type DataTableRechercheAttributs = Omit<\n ComponentProps<\"input\">,\n \"value\" | \"defaultValue\" | \"onChange\" | \"type\" | \"ref\"\n>\n\nexport interface DataTableToolbarProps<TData extends RowData = RowData> {\n /** Champ de recherche, contrôlé (l'application temporise sa requête). */\n recherche?: {\n valeur: string\n onValeurChange: (valeur: string) => void\n placeholder?: string\n /** Nom du champ. « Rechercher » par défaut. */\n libelle?: string\n /** Attributs ajoutés au champ (`name`, `data-*`…). Le champ porte déjà\n * `autoComplete=\"off\"` et les attributs qui écartent les gestionnaires\n * de mots de passe ; ils peuvent être remplacés ici. */\n attributs?: DataTableRechercheAttributs\n }\n /** Filtres : `DataTableSelectFilter`… */\n filtres?: ReactNode\n /**\n * Nombre de filtres actifs. Fourni, il replie les filtres derrière un\n * bouton « Filtres (n) » sur mobile, où ils s'empileraient sinon au-dessus\n * des résultats, et affiche « Réinitialiser » s'il y en a.\n */\n filtresActifs?: number\n /** Retire tous les filtres (bouton « Réinitialiser »). */\n onReinitialiser?: () => void\n /** Compteur « N éléments · a–b affichés » : ses nombres, ou `{ table }`\n * pour une pagination côté client. */\n compteur?: DataTableCountProps<TData>\n /** À droite : `DataTableViewOptions`, bouton d'ajout… */\n children?: ReactNode\n className?: string\n}\n\n/**\n * Barre d'outils au-dessus d'un tableau, sur le modèle de celle de shadcn :\n * recherche et filtres à gauche, compteur et commandes (colonnes…) à droite.\n */\nexport function DataTableToolbar<TData extends RowData = RowData>({\n recherche,\n filtres,\n filtresActifs,\n onReinitialiser,\n compteur,\n children,\n className,\n}: DataTableToolbarProps<TData>) {\n const mobile = useIsMobile()\n const replier = mobile && filtres != null && filtresActifs !== undefined\n const racineRef = useRef<HTMLDivElement>(null)\n const rechercheRef = useRef<HTMLInputElement>(null)\n\n // « Réinitialiser » disparaît avec les filtres : le focus passe d'abord au\n // champ de recherche, sinon au premier filtre (ou au bouton « Filtres »),\n // au lieu de tomber sur <body>.\n const reinitialiser = () => {\n racineRef.current\n ?.querySelector<HTMLElement>(\n 'input[type=\"search\"], [data-slot=\"popover-trigger\"], [data-slot=\"select-trigger\"]'\n )\n ?.focus()\n onReinitialiser?.()\n }\n\n return (\n <div\n ref={racineRef}\n data-slot=\"data-table-toolbar\"\n className={cn(\"flex flex-wrap items-center gap-2\", className)}\n >\n {recherche ? (\n <InputGroup className=\"w-full sm:w-64\">\n <InputGroupAddon>\n <SearchIcon />\n </InputGroupAddon>\n <InputGroupInput\n // Une recherche n'est jamais un identifiant : sans ces attributs,\n // les gestionnaires de mots de passe y proposent une adresse.\n {...NO_AUTOFILL}\n {...recherche.attributs}\n ref={rechercheRef}\n type=\"search\"\n aria-label={recherche.libelle ?? \"Rechercher\"}\n placeholder={recherche.placeholder ?? \"Rechercher…\"}\n value={recherche.valeur}\n onChange={(event) => recherche.onValeurChange(event.target.value)}\n // La croix native de Chrome (bleue, 14 px, absente de Firefox)\n // cède la place au bouton ci-dessous.\n className={cn(\n \"[&::-webkit-search-cancel-button]:appearance-none\",\n recherche.attributs?.className\n )}\n />\n {recherche.valeur ? (\n <InputGroupAddon align=\"inline-end\">\n <Tooltip>\n <TooltipTrigger\n render={\n <InputGroupButton\n size=\"icon-xs\"\n aria-label=\"Effacer la recherche\"\n onClick={() => {\n // Le bouton disparaît : le focus revient au champ.\n rechercheRef.current?.focus()\n recherche.onValeurChange(\"\")\n }}\n />\n }\n >\n <XIcon />\n </TooltipTrigger>\n <TooltipContent>Effacer la recherche</TooltipContent>\n </Tooltip>\n </InputGroupAddon>\n ) : null}\n </InputGroup>\n ) : null}\n {replier ? (\n <Popover>\n <PopoverTrigger render={<Button variant=\"outline\" />}>\n <ListFilterIcon data-icon=\"inline-start\" />\n Filtres{filtresActifs ? ` (${filtresActifs})` : \"\"}\n </PopoverTrigger>\n <PopoverContent\n align=\"start\"\n className=\"w-64 *:data-[slot=select-trigger]:w-full\"\n >\n {filtres}\n </PopoverContent>\n </Popover>\n ) : (\n filtres\n )}\n {filtresActifs && onReinitialiser ? (\n <Button variant=\"ghost\" onClick={reinitialiser}>\n Réinitialiser\n <XIcon data-icon=\"inline-end\" />\n </Button>\n ) : null}\n {compteur || children ? (\n <div className=\"ml-auto flex flex-wrap items-center gap-x-4 gap-y-2\">\n {compteur ? <DataTableCount {...compteur} /> : null}\n {children}\n </div>\n ) : null}\n </div>\n )\n}\n"],"mappings":"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"}
|
|
@@ -366,7 +366,9 @@ export interface DataTableExpandColumnOptions<TData extends RowData> {
|
|
|
366
366
|
*/
|
|
367
367
|
export declare function dataTableExpandColumn<TData extends RowData>({ libelleLigne, libelle, }?: DataTableExpandColumnOptions<TData>): DataTableColumnDef<TData>;
|
|
368
368
|
export interface DataTableRowActionsProps {
|
|
369
|
-
/** Entrées du menu : `
|
|
369
|
+
/** Entrées du menu : `DropdownMenuAction` (avec `verrou` pour une action
|
|
370
|
+
* impossible, sa raison affichée), `DropdownMenuItem`,
|
|
371
|
+
* `DropdownMenuSeparator`… */
|
|
370
372
|
children: ReactNode;
|
|
371
373
|
/** Nom du bouton, lu et affiché en infobulle, propre à la ligne pour que
|
|
372
374
|
* les boutons se distinguent : « Actions pour Ada Lovelace ». */
|