Skip to Content
Documentation
Afficher et explorer

Groupement et calculs

Grouper les lignes et calculer sur le bon périmètre.

Le groupement facilite la lecture par catégories. Les calculs de pied de tableau répondent à des questions sur le résultat filtré : stock total, prix moyen ou nombre de valeurs renseignées.

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.

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

export const groupingConfig = defineTableConfig({
  ...productConfig,
  columns: {
    ...productConfig.columns,
    definitions: productConfig.columns.definitions.map((column) =>
      column.id === "stock" ? { ...column, defaultCalculation: "sum" } : column
    ),
  },
  table: {
    ...productConfig.table,
    enableGrouping: true,
    enableCalculations: true,
  },
});
grouping-config.ts
import { defineTableConfig } from "@/components/ui/yayaw-table-vue/config";
import { productConfig } from "./product-config";

export const groupingConfig = defineTableConfig({
  ...productConfig,
  columns: {
    ...productConfig.columns,
    definitions: productConfig.columns.definitions.map((column) =>
      column.id === "stock" ? { ...column, defaultCalculation: "sum" } : column
    ),
  },
  table: {
    ...productConfig.table,
    enableGrouping: true,
    enableCalculations: true,
  },
});

Valeurs initiales des colonnes

defaultCalculation choisit le calcul initial. enableCalculation: false exclut une colonne des calculs. enableGrouping: false l’exclut des choix de groupement. Les vues enregistrées et les choix courants peuvent remplacer les valeurs initiales.

Éditer ou figer les calculs

Le pied de tableau est en lecture seule par défaut : chaque colonne affiche son calcul (le choix du lecteur, sinon defaultCalculation) en texte, et les colonnes sans calcul n’affichent rien : plus de bouton « Calculer » sous des colonnes que personne ne totalise. Si aucune colonne visible n’a de calcul, la ligne de pied n’est pas affichée. Pour changer les calculs, le lecteur active Éditer les calculs dans les Réglages de la vue : chaque colonne calculable propose alors son menu. Ce switch est désactivé à chaque visite et n’est pas enregistré dans les vues ; l’activer réaffiche aussi un pied qu’une ancienne vue avait masqué.

Pour figer un calcul, mettez lockCalculation: true sur la colonne : elle affiche toujours son defaultCalculation, même en mode édition, et ignore un choix fait auparavant par le lecteur. Une colonne figée sans defaultCalculation n’affiche rien. table.lockCalculations: true fige toutes les colonnes ; lockCalculation: false sur une colonne la garde modifiable. Si toutes les colonnes calculables sont figées, le switch est masqué. React et Vue se comportent de la même façon.

const config = {
  ...productConfig,
  columns: {
    ...productConfig.columns,
    definitions: productConfig.columns.definitions.map((column) =>
      column.id === "stock"
        ? { ...column, defaultCalculation: "sum", lockCalculation: true }
        : column
    ),
  },
  table: { ...productConfig.table, enableCalculations: true },
};

Groupement et pagination serveur

Les groupes organisent les lignes chargées sur la page courante. Avec une pagination serveur, un groupe peut continuer sur une autre page ; son nombre de lignes visibles n’est pas le total global de la catégorie. Utilisez les agrégations serveur pour les totaux sur tout le résultat filtré.

Quand un groupement est actif, l’écran de groupement des réglages de la vue propose une action qui retire tous les champs de groupement ensemble. React et Vue reviennent à un tableau sans groupement en conservant les filtres et le tri courants. Cette action efface uniquement le groupement ; utilisez Réinitialiser la vue pour restaurer toute la présentation de la vue enregistrée.

Calculer sur tout le résultat filtré

Fournissez aggregate lorsque le serveur peut calculer efficacement les agrégations demandées. Il reçoit recherche, filtres, règles avancées et la table calculations. Renvoyez results[columnId] avec une valeur exploitable (raw), un label formaté et le nombre de lignes correspondantes. Sans action d’agrégation, le tableau peut charger d’autres pages. Ne présentez jamais un sous-total de page comme le total global.

Résultats de la sélection et de la page

Tant que des lignes sont sélectionnées, chaque pied de colonne affiche son calcul sur ces lignes, avec leur nombre, par exemple « Somme · Sélection (2) ». L’infobulle du résultat donne les autres portées : la page affichée lorsque les lignes correspondantes s’étendent sur plusieurs pages (« Cette page : 10 »), et toutes les lignes correspondantes pendant une sélection (« Toutes les lignes : 40 »). Les deux sont calculées dans le navigateur à partir des lignes qu’il détient, par devise comme tout calcul local : l’action aggregate du serveur ne répond toujours qu’au résultat filtré complet. Clés de traduction : calculations.selection, calculations.page et calculations.all.

Vérifier un total de stock

La recette stock commence à 18 unités. Passer le bureau de 12 à 15 doit donner 21 unités. Filtrer sur Draft doit donner zéro. Le groupement change la présentation, pas les lignes appartenant à la requête.

Pour les mutations, reprenez le rafraîchissement explicite du cache dans la recette stock. Le registre React vérifié utilise des clés distinctes pour les lignes et les calculs.

Calculer les totaux de stock

Déclarez Somme sur Stock et activez les calculs de pied de tableau. Le parcours stock montre comment actualiser les totaux après une écriture validée.

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.

Limiter le groupement à un champ pertinent

Autorisez le groupement par Statut et excluez les mesures numériques du sélecteur. Le mode tableau accepte jusqu’à deux champs lorsque le schéma le permet.

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.

Totaux en plusieurs devises

Une colonne de nombres dont numberFormat.currencyColumn nomme la devise de chaque ligne n’est jamais additionnée entre devises : sommes, moyennes, médianes, minimums, maximums et écarts sont calculés par devise, et le pied de tableau (et les sous-totaux de groupe en React) affiche un montant par devise, comme « 1 200,00 € · 300,00 $ ». Les comptes et les parts ne changent pas. numberFormat.currencyConversion affiche plutôt un seul total converti ; voir montants en plusieurs devises.