groupShow

Les colonnes qu’un groupe repliable garde quand il se replie.

Type	'open' | 'closed'
Par défaut	non défini
Modifiable en direct (update())	Oui — en redonnant les colonnes (update({ columns }))
Déclaré dans	packages/core/src/columns/defs.ts

Ce qu’il fait

Un groupe de colonnes avec collapsible: true s’ouvre et se ferme par un bouton dans son titre (Entrée ou Espace dessus). Ses colonnes marquées groupShow: 'open' ne s’affichent que quand il est ouvert, celles marquées 'closed' que quand il est fermé ; les autres toujours. Sans groupShow, une colonne s’affiche dans les deux cas. Sous un groupe qui ne s’ouvre ni ne se ferme, il est ignoré.

Les lignes de titres de groupes demandent la fonction spans(), et le bouton la fonction groups() de @dzgrid/dom/groups (textes -columns). Le open: false du groupe le fait démarrer fermé.

Exemple

import { createGrid, type GridMessages } from '@dzgrid/dom';
import { spans } from '@dzgrid/dom/spans';
import { groups } from '@dzgrid/dom/groups';
import { FR_COLUMNS } from '@dzgrid/dom/locales/fr-columns';
import { FR } from '@dzgrid/dom/locales/fr';

type Station = { id: string; name: string; tempMin: number; tempMax: number; rain: number };

const messages: GridMessages = { ...FR, text: { ...FR.text, ...FR_COLUMNS.text } };

createGrid<Station>(document.getElementById('stations')!, {
  rows: [{ id: 's1', name: 'Cap Lumière', tempMin: 4, tempMax: 17, rain: 2.5 }],
  columns: [
    { id: 'name', header: 'Station' },
    {
      id: 'weather',
      header: 'Météo',
      collapsible: true,
      children: [
        { id: 'tempMin', header: 'Min °C', type: 'number', groupShow: 'open' },
        { id: 'tempMax', header: 'Max °C', type: 'number' },
        { id: 'rain', header: 'Pluie (mm)', type: 'number', groupShow: 'open' },
      ],
    },
  ],
  getRowId: (r) => r.id,
  messages,
  features: [spans(), groups()],
});

Démo

Le bouton du groupe replie Météo sur sa colonne Max °C.

Voir aussi

• hidden.
• Colonnes.