Mise en page et colonnes
Ajuster densité, dimensions, épinglage, ordre et états vides.
Choisissez un préréglage pour une interface d’administration, un catalogue ou un aperçu compact. Ajustez ensuite les comportements utiles à votre produit.
Barre d'outils responsive
La barre d'outils sépare le sélecteur de vues, à gauche, des Réglages de la
vue et du bouton Données, à droite. Desktop conserve une ligne : onglets
de vues (ou le déclencheur nommé, avec son icône, le nom de la vue et le
chevron), recherche, actions de l'application, Réglages de la vue,
Données et ajout. actionsAsIcons contrôle les libellés des actions de
l'application ; le menu de débordement disparaît sur desktop. Sous 768px, ou
si le conteneur ne peut plus tenir sur une ligne, la barre devient
vue · + · … : le déclencheur de vue se réduit à un bouton à icône seule —
nom accessible et point de changements non enregistrés seulement, sans
libellé ni chevron — pour laisser la place à la recherche sur la ligne, qui se
replie en un bouton ouvrant le champ. Archives est un exemple fourni par
l'application, pas une action native.
Les Réglages de la vue ne portent que sur la présentation — mise en page,
densité, propriétés, filtre, tri, groupement, Éditer les calculs et réglages de
carte — sans section Données à l'intérieur. Exporter, Connecter et Partager
vivent dans leur propre menu Données, ouvert depuis un bouton à icône de
base de données à côté des Réglages de la vue : une ligne Exporter ›, une
ligne Connecter › (destinations de connexion
personnalisées, masquée sans elles) et
une ligne Partager › (un écran listant « Copier le lien » suivi des
destinations de partage personnalisées, ou une action directe de copie sans
elles), toutes deux déclarées dans actions.destinations. En mode compact, le
menu Données liste aussi les actions de la barre d'outils de l'application ;
il n'y a plus de panneau des actions séparé. Sur les grands écrans, ces
actions de l'application restent des boutons de la barre d'outils avant les
Réglages de la vue, dont le bouton icône porte un badge comptant les
filtres et tris actifs.
Les réglages utilisent un panneau ancré sur desktop et un panneau modal défilant en présentation compacte. Les cibles mobiles font au moins 44px. La mise en page et la densité sont des lignes affichant leur valeur courante qui ouvrent une liste de choix, comme les propriétés, le filtre, le tri et le groupement ; ces écrans possèdent un retour. Les filtres rapides configurés rejoignent Filtres en mode compact. La barre desktop conserve ses contrôles de 32px ; la densité ne redimensionne que les données.
| Réglage | Tableau | Kanban | Galerie |
|---|---|---|---|
| Recherche, filtres, tri | Disponibles | Disponibles | Disponibles |
| Champs de groupement | Jusqu'à 2 | 1 | 1 |
| Densité | 2XS, XS, S, M, L, XL, 2XL | Masquée | Masquée |
| Propriétés | Colonnes, dimensions, épinglage | Propriétés des cartes | Propriétés des cartes |
| Éditer les calculs | Si activés | Masqué | Masqué |
| Présentation des cartes | Masquée | Titre, propriétés, libellés | Aussi image, format, ajustement et taille |
Mode et densité sont accessibles directement dans le menu de la vue. La densité est un groupe radio avec un libellé visible et des choix régulièrement espacés, le choix sélectionné mis en évidence : un seul arrêt de tabulation, et les flèches déplacent le choix. La ligne Mode d’affichage montre le mode courant et ouvre un écran de tuiles de mise en page, trois par ligne. Les flags et les capacités des colonnes peuvent masquer d'autres réglages. Un changement de présentation préserve les réglages inactifs. Les raccourcis de filtres et de tri depuis les en-têtes restent disponibles.
+ Filtre reste visible dans la ligne de filtres sous la barre d’outils,
même avant la première règle. L’écran Filtre des réglages de la vue ouvre
le même sélecteur de colonnes. Chaque règle s’affiche comme une puce, avec une
action pour les effacer tant que des règles sont présentes. Les nombres et le texte saisis filtrent dès une
pause dans la saisie, sur Entrée ou en quittant le champ : saisir 24
n’applique jamais 2 et 4 séparément. Zéro, les nombres négatifs et les
décimales sont acceptés. Un intervalle s’applique dès que ses deux bornes sont
complètes. Échap rétablit la valeur appliquée. Voir
Le menu de filtre. L’exemple Vue active
enableAdvancedFilters pour tester ce parcours avec le tri et le groupement.
Exemple de configuration
Partez du démarrage React ou du démarrage Vue. Le fichier suivant complète leur catalogue de produits. Passez cette configuration via getTableConfig en React ou config en Vue.
import { defineTableConfig } from "@/components/ui/yayaw-table/config/helpers";
import { productConfig } from "./product-config";
export const layoutConfig = defineTableConfig({
...productConfig,
table: {
...productConfig.table,
layoutPreset: "admin",
density: "small",
actionsAsIcons: false,
enableViews: true,
allowViewSave: true,
enableColumnDnd: true,
enableColumnDragDropByDefault: false,
enableColumnResizing: true,
enableColumnPinning: true,
emptyState: {
title: "No products match",
description: "Clear filters or try another name.",
},
},
});import { defineTableConfig } from "@/components/ui/yayaw-table-vue/config";
import { productConfig } from "./product-config";
export const layoutConfig = defineTableConfig({
...productConfig,
table: {
...productConfig.table,
layoutPreset: "admin",
density: "small",
actionsAsIcons: false,
enableViews: true,
allowViewSave: true,
enableColumnDnd: true,
enableColumnDragDropByDefault: false,
enableColumnResizing: true,
enableColumnPinning: true,
emptyState: {
title: "No products match",
description: "Clear filters or try another name.",
},
},
});Rendre les ajustements réversibles
Réinitialiser la vue, à côté du bouton de fermeture des Réglages de la vue, restaure la vue enregistrée active, ou la vue par défaut configurée si aucune vue n’est sélectionnée. Cette action retire les modifications temporaires des filtres, du tri, du regroupement et de la présentation sans modifier la vue enregistrée. Le bouton est désactivé lorsque la vue est inchangée.
L’ordre, la visibilité, la largeur et l’épinglage sont des états utilisateur. Les colonnes obligatoires restent disponibles. Conservez les identifiants lors d’un changement de libellé pour préserver les vues. enableColumnDnd expose la fonctionnalité ; enableColumnDragDropByDefault contrôle son activation initiale.
Prévoir les petits écrans
Utilisez le thème Shadcn de l’application et un conteneur pouvant rétrécir (min-width: 0). Testez les longues valeurs, un écran étroit, le menu d’actions groupées et un résultat vide. Masquer la barre d’outils peut supprimer les contrôles permettant de sortir d’un ancien filtre enregistré.
Le panneau reprend les couleurs de popover, bordures et arrondis du thème Shadcn de l'application. Sa hauteur suit son contenu ; une seule zone de défilement intervient lorsque la hauteur disponible est dépassée. Le groupement conserve l'ordre des colonnes, y compris la sélection, pour aligner les en-têtes de groupe et les cellules des lignes.
Les sélecteurs natifs de Vue suivent le thème clair ou sombre de l’application, y compris le fond et le texte des options, pour garder les choix en cellule lisibles dans les deux thèmes.
Les exemples exécutables React et Vue proposent Custom onBulkEdit :
sélectionnez plusieurs lignes, ouvrez l'édition groupée et appliquez un statut à
ces lignes. Lorsque l'option est désactivée, le formulaire généré du catalogue
gère l'édition groupée. Dans un handler React personnalisé, invalidez les requêtes
tableData et tableColumnCalculations après l'écriture pour actualiser ensemble
les lignes filtrées et les totaux.
En React, getTableActions().list doit appliquer la recherche globale, les filtres
de colonnes, les filtres avancés et le tri avant la pagination. La barre d'outils
modifie la requête ; renvoyer les mêmes lignes ne les filtre ni ne les trie.
L'exemple responsive cherche dans chaque colonne de données, y compris les
statuts, nombres et booléens. L'exemple Vue sur données locales applique la même
requête avant la pagination.
Afficher les libellés sur desktop
Gardez les actions desktop libellées. En largeur compacte, la barre passe au déclencheur de vue à icône seule, à un bouton de recherche, aux Réglages de la vue et à Ajouter ; les entrées des menus restent lisibles.
Copiez cette configuration complète à côté de product-config.ts. Utilisez () => exampleConfig pour getTableConfig en React, ou :config="exampleConfig" en Vue.
Données de démonstration. Les modifications restent dans cet aperçu.
import { defineTableConfig } from "@/components/ui/yayaw-table/config/helpers";
import { productConfig } from "./product-config";
export const exampleConfig = defineTableConfig({
...productConfig,
table: {
...productConfig.table,
actionsAsIcons: false,
density: "medium",
enableViews: false,
},
});Données de démonstration. Les modifications restent dans cet aperçu.
import { defineTableConfig } from "@/components/ui/yayaw-table-vue/config";
import { productConfig } from "./product-config";
export const exampleConfig = defineTableConfig({
...productConfig,
table: {
...productConfig.table,
actionsAsIcons: false,
density: "medium",
enableViews: false,
},
});Utiliser des icônes et une table plus dense
Le flag d’icônes concerne les actions desktop. La densité appartient à la vue courante et n’est proposée qu’en mode tableau.
Copiez cette configuration complète à côté de product-config.ts. Utilisez () => exampleConfig pour getTableConfig en React, ou :config="exampleConfig" en Vue.
Données de démonstration. Les modifications restent dans cet aperçu.
import { defineTableConfig } from "@/components/ui/yayaw-table/config/helpers";
import { productConfig } from "./product-config";
export const exampleConfig = defineTableConfig({
...productConfig,
table: {
...productConfig.table,
actionsAsIcons: true,
density: "small",
displayModes: ["table", "kanban", "gallery"],
kanban: { groupBy: "status", titleColumn: "name" },
gallery: { titleColumn: "name" },
},
});Données de démonstration. Les modifications restent dans cet aperçu.
import { defineTableConfig } from "@/components/ui/yayaw-table-vue/config";
import { productConfig } from "./product-config";
export const exampleConfig = defineTableConfig({
...productConfig,
table: {
...productConfig.table,
actionsAsIcons: true,
density: "small",
displayModes: ["table", "kanban", "gallery"],
kanban: { groupBy: "status", titleColumn: "name" },
gallery: { titleColumn: "name" },
},
});