Skip to Content
Documentation
Afficher et explorer

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églageTableauKanbanGalerie
Recherche, filtres, triDisponiblesDisponiblesDisponibles
Champs de groupementJusqu'à 211
Densité2XS, XS, S, M, L, XL, 2XLMasquéeMasquée
PropriétésColonnes, dimensions, épinglagePropriétés des cartesPropriétés des cartes
Éditer les calculsSi activésMasquéMasqué
Présentation des cartesMasquéeTitre, propriétés, libellésAussi 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.

layout-config.ts
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.",
    },
  },
});
layout-config.ts
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.

Agrandir ↗

Données de démonstration. Les modifications restent dans cet aperçu.

Agrandir ↗

Données de démonstration. Les modifications restent dans cet aperçu.

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.

Agrandir ↗

Données de démonstration. Les modifications restent dans cet aperçu.

Agrandir ↗

Données de démonstration. Les modifications restent dans cet aperçu.