Skip to Content
Documentation
Vues

Kanban

Transformer une colonne de statut typée en tableau Kanban.

Le Kanban utilise les mêmes lignes, requêtes et actions de modification que le tableau. Groupez par un statut à valeurs finies et n’affichez que les propriétés utiles sur les cartes.

Réglages des cartes

Ouvrez Vue → Réglages des cartes pour sélectionner le titre et les propriétés visibles. Les propriétés et les libellés utilisent des cases à cocher qui restent ouvertes pour plusieurs modifications. Le champ de regroupement reste dans Vue → Grouper. Sur mobile, les choix restent dans le tiroir de la vue et Retour rétablit le contrôle d’origine. Les menus courts n’imposent pas de barre de défilement ; les longues listes restent accessibles par défilement.

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.

pipeline-config.ts
import { defineTableConfig } from "@/components/ui/yayaw-table/config/helpers";
import { productConfig } from "./product-config";

export const pipelineConfig = defineTableConfig({
  ...productConfig,
  table: {
    ...productConfig.table,
    displayModes: ["table", "kanban"],
    defaultDisplayMode: "kanban",
    allowEdit: true,
    enableColumnFilters: true,
    enableAdvancedFilters: true,
    enableViews: true,
    allowViewSave: true,
    allowInlineEdit: true,
    enableGrouping: true,
    kanban: {
      groupBy: "status",
      titleColumn: "name",
      cardColumnIds: ["price", "stock"],
      showCardLabels: true,
    },
  },
});
pipeline-config.ts
import { defineTableConfig } from "@/components/ui/yayaw-table-vue/config";
import { productConfig } from "./product-config";

export const pipelineConfig = defineTableConfig({
  ...productConfig,
  table: {
    ...productConfig.table,
    displayModes: ["table", "kanban"],
    defaultDisplayMode: "kanban",
    allowEdit: true,
    enableColumnFilters: true,
    enableAdvancedFilters: true,
    enableViews: true,
    allowViewSave: true,
    allowInlineEdit: true,
    enableGrouping: true,
    kanban: {
      groupBy: "status",
      titleColumn: "name",
      cardColumnIds: ["price", "stock"],
      showCardLabels: true,
    },
  },
});

Enregistrer le déplacement d’une carte

Déplacer une carte entre des colonnes modifiables met à jour le champ de groupement via update(id, patch). Fournissez cette action et les autorisations d’édition. Un tableau éditable uniquement en cellule (allowEdit: false) doit activer allowInlineEdit et déclarer explicitement inlineEdit: true sur son champ de regroupement à valeur unique. canEditRow reste appliqué à chaque carte. L’écriture utilise accessorKey si présent et conserve le type de la valeur d’option correspondante. Le serveur doit valider les transitions et renvoyer un échec lorsqu’il en refuse une. Utilisez des valeurs stables comme draft, active et archived ; leurs libellés peuvent être traduits.

Avec kanban.allowDragUpdate, les cartes se déplacent par leur poignée. Définissez kanban.dragFromCard: true pour démarrer le glisser depuis n’importe quel point de la carte : un clic ou un appui court ouvre toujours l’enregistrement, et la case à cocher, les liens et les menus de la carte gardent leur comportement. Le déplacement depuis toute la carte masque la poignée devenue inutile. Au clavier, le contrôle de déplacement React apparaît au focus ; une carte Vue ayant le focus se déplace avec Alt+Maj+Gauche/Droite.

Garder un tableau lisible

titleColumn fournit le titre et cardColumnIds les propriétés ; sans lui, toutes les propriétés de données sauf le titre et la colonne regroupée sont affichées. Recherche, filtres et vues enregistrées restent applicables. Des données serveur paginées ne représentent que les lignes récupérées ; ne présentez pas un compteur de colonne comme un total global sans contrat serveur adapté. Consultez la recette pipeline.

Créer un tableau par statut

Utilisez les trois statuts comme colonnes et affichez seulement le titre et le stock. Branchez editableActions pour que déplacer une carte enregistre son statut.

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.

Afficher les libellés sur des cartes détaillées

Exposez le prix et le stock avec leurs libellés pour la revue des produits. La densité et les calculs de pied de tableau sont masqués en Kanban.

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.

Colonnes chargées sur le serveur

Pour un tableau de suivi complet avec une pagination par colonne, configurez table.kanban.server. groups(signal) renvoie { value, label, totalCount }[] avec des compteurs sur toute la requête autorisée. rows(group, cursor, signal) renvoie { rows, nextCursor } ; null termine la colonne. Le premier curseur vaut null. Chaque colonne se charge séparément et conserve ses lignes et son curseur après un échec.

queryKey représente les filtres, la recherche, le tri, le compte et la révision d’actualisation. Capturez cette requête dans les callbacks et respectez AbortSignal. Changer la clé remplace le tableau précédent. Le serveur contrôle les droits sur les compteurs comme sur les pages ; les compteurs ne sont jamais déduits des seules lignes chargées.

getRowId(row) utilise par défaut String(row.id). onActivate(row) gère la navigation. labels traduit loading, retry, loadMore et empty. Les tableaux distants permettent de déplacer les cartes dans React et Vue avec kanban.allowDragUpdate: true, l’action update du tableau et les mêmes droits que les tableaux locaux. dragFromCard: true active le glisser depuis toute la carte, sans poignée visible ; sinon, utilisez la poignée. Dans les deux versions distantes, Alt+Maj+Gauche/Droite déplace la carte ayant le focus, sans ajouter de boutons fléchés visibles. Seules les colonnes visibles sont proposées comme destination.

Un déplacement enregistre une ligne, puis recharge les groupes autorisés et leur première page : totaux, filtres, tri et curseurs suivent le résultat du serveur. Pendant l’enregistrement, les autres déplacements et la pagination des colonnes sont bloqués. Un refus laisse la carte en place, affiche l’erreur et permet de réessayer. Un changement de requête ou de compte écarte les réponses obsolètes. Déplacer dans une même colonne n’enregistre pas un ordre manuel. Le champ de regroupement configuré pour le tableau doit rester actif.

La sélection, les commandes groupées et la pagination de la grille ne s’appliquent toujours pas aux colonnes distantes incomplètes. Utilisez la grille pour les opérations groupées. Les colonnes calculées depuis un workflow exigent une action métier de transition ; leur étape calculée n’est pas un simple statut.

Colonnes par vue

kanban.lanes conserve l’ordre et les colonnes masquées de chaque champ de regroupement, par exemple { "status": { "order": ["won", "lead"], "hidden": ["lost"] } }. Les colonnes que l’ordre ne nomme pas suivent dans leur ordre habituel, et un ordre ne crée jamais de colonne vide. Les colonnes masquées cachent leurs cartes et le tableau les liste en dessous. Une vue enregistrée porte son propre kanban.lanes : changer de vue change les colonnes ; table.kanban.lanes sert de défaut pour les champs de regroupement qu’une vue ne nomme pas, et chaque champ garde ses colonnes quand le regroupement change puis revient.

Dans Vue → Réglages des cartes, chaque colonne du champ de regroupement peut être affichée ou masquée et montée ou descendue, et une réinitialisation revient aux colonnes par défaut. Ce sont des modifications de la vue, enregistrées comme les propriétés des cartes. Les colonnes chargées sur le serveur (kanban.server) sont ordonnées et masquées de la même façon.

Avatars

kanban.avatar (true, ou { nameColumn, imageColumn, shape }) affiche un avatar avant le titre de chaque carte : l’image de imageColumn quand elle se charge, sinon jusqu’à deux initiales sur une couleur stable tirée de nameColumn (par défaut, le titre). shape vaut "circle" (par défaut) ou "square". À côté du titre, l’avatar est décoratif. L’option est enregistrée avec les réglages des cartes de la vue.