Référence des colonnes
Configuration des colonnes, types, ordre et visibilité
Colonnes produit typées
Cet exemple complet utilise le démarrage et les fichiers communs des recettes. La référence ci-dessous détaille les options et les fragments d’intégration.
import { defineTableConfig } from "@/components/ui/yayaw-table";
export const productConfig = defineTableConfig({
id: "products",
translations: { namespace: "products", keys: {} },
columns: {
definitions: [
{ id: "name", header: "Name", type: "text" },
{ id: "price", header: "Price", type: "number" },
{ id: "stock", header: "Stock", type: "number" },
{
id: "status",
header: "Status",
type: "select",
options: [
{ label: "Draft", value: "draft" },
{ label: "Active", value: "active" },
{ label: "Archived", value: "archived" },
],
},
],
order: ["name", "price", "stock", "status"],
visible: ["name", "price", "stock", "status"],
mandatory: ["name"],
sort: [{ id: "name", desc: false }],
},
table: {
allowCreate: false,
allowEdit: false,
allowDelete: false,
allowDuplicate: false,
allowBulkEdit: false,
allowBulkDelete: false,
enableRowSelection: false,
enableViews: false,
syncUrl: false,
defaultPageSize: 10,
},
});
export const getTableConfig = (tableType: string) =>
tableType === "products" ? productConfig : undefined;import { defineTableConfig } from "@/components/ui/yayaw-table-vue";
export const productConfig = defineTableConfig({
id: "products",
translations: { namespace: "products", keys: {} },
columns: {
definitions: [
{ id: "name", header: "Name", type: "text" },
{ id: "price", header: "Price", type: "number" },
{ id: "stock", header: "Stock", type: "number" },
{
id: "status",
header: "Status",
type: "select",
options: [
{ label: "Draft", value: "draft" },
{ label: "Active", value: "active" },
{ label: "Archived", value: "archived" },
],
},
],
order: ["name", "price", "stock", "status"],
visible: ["name", "price", "stock", "status"],
mandatory: ["name"],
sort: [{ id: "name", desc: false }],
},
table: {
allowCreate: false,
allowEdit: false,
allowDelete: false,
allowDuplicate: false,
allowBulkEdit: false,
allowBulkDelete: false,
enableRowSelection: false,
enableViews: false,
syncUrl: false,
defaultPageSize: 10,
},
});
export const getTableConfig = (tableType: string) =>
tableType === "products" ? productConfig : undefined;Référence des colonnes
Déclarez les colonnes dans columns.definitions, puis contrôlez l'ordre et la visibilité via columns.order et columns.visible.
columns.order est l’ordre dans lequel la table démarre : les colonnes qu’il liste, dans cet ordre, puis les autres dans l’ordre des définitions, avec select en premier et actions en dernier. L’ordre d’une vue enregistrée, ou celui de la personne dès qu’elle déplace une colonne, le remplace. React le suit depuis v3.9.2 ; avant, il démarrait dans l’ordre des définitions.
columns: {
definitions: [
{ id: 'name', type: 'text', header: 'Name', enableSorting: true, enableColumnFilter: true },
{
id: 'price',
type: 'number',
header: 'Price',
numberFormat: { thousandsSeparator: ' ', decimals: 0, suffix: ' €' },
},
{ id: 'imageUrl', type: 'image', header: 'Image', enableSorting: false, enableColumnFilter: false },
{ id: 'status', type: 'tag', header: 'Status' },
{ id: 'metadata', type: 'json', header: 'Metadata', maxItems: 4 },
{ id: 'externalUrl', type: 'url', header: 'External URL' },
{ id: 'createdAt', type: 'date', header: 'Created', dateDisplayPreset: 'dmy-numeric' },
{ id: 'isActive', type: 'boolean', header: 'Active' },
{ id: 'actions', type: 'actions', header: 'Actions' },
{ id: 'value', type: 'dynamicType', typeKey: 'valueType', header: 'Value' },
],
order: ['select', 'name', 'price', 'status', 'createdAt', 'actions'],
visible: ['select', 'name', 'price', 'status', 'createdAt', 'actions'],
mandatory: ['name'],
}Types
Types de colonnes supportés :
textstringnumberbooleandateselectmultiSelecttagcodejsonlocation(un lieu{ lat, lng, label?, address? }, voir Colonnes de lieu)urlimage(chaîne URL avec fallback automatique si vide ou invalide)actionsdynamicType(renderer sélectionné viatypeKey)
La checkbox de sélection de ligne est une colonne virtuelle avec l'id select ;
elle est distincte des colonnes de données qui utilisent type: 'select'.
Options par colonne
Propriétés communes :
id: string– Identifiant uniqueheader: string | React.ReactNodeenableSorting?: boolean(par défauttrue)enableColumnFilter?: boolean(par défauttrue)enableResizing?: boolean– autorise le redimensionnement de cette colonne quandtable.enableColumnResizingest activé (par défauttruepour les colonnes de données)size?: number,minSize?: number,maxSize?: number– largeur initiale et limites autorisées en pixelsaccessorKey?: string– Accesseur optionnel si la clé de donnée diffère deiddateDisplayPreset?: DateDisplayPreset– preset strict pour le rendu des dates (colonnes date uniquement)dateFormat?: string– repli hérité au format date-fns pour les colonnes dateenableCalculation?: boolean– active/désactive les calculs du footer pour cette colonne une foistable.enableCalculationsactivé (par défauttrue, sauf colonnes systèmeselect/actions)defaultCalculation?: CalculationType– calcul par défaut affiché pour cette colonne (validé selon le type de colonne)lockCalculation?: boolean– fige le pied surdefaultCalculation: pas de menu, même avec Éditer les calculs activé, et rien d’affiché sansdefaultCalculation(par défauttable.lockCalculations). Voir Éditer ou figer les calculs.inlineEdit?: boolean | InlineEditColumnConfig– active/configure l'édition inline pour cette colonneenableExport?: boolean–falsegarde la colonne dans la table : elle n'apparaît jamais dans les listes de colonnes de l'écran d'export, la requêteactions.exportFile, le CSV de la sélection, lescolumnsdes destinations Connecter ni la correspondance d'un connecteur (par défauttrue). Voir Écran d'export.cellActions?: CellActionDefinition[]– petites commandes dessinées après la valeur de la cellule, à la taille de la densité. Voir Actions de cellule.copyable?: boolean– ajoute une action qui copie la valeur de la cellule dans le presse-papiers.Pour les colonnes number :
numberFormat?: NumberFormatConfig– format d'affichage (séparateurs milliers/décimales, décimales, préfixe/suffixe monétaire). Voir Number column ci-dessous.Pour les colonnes json :
maxItems?: number– nombre maximal d'items objet/tableau affichés avant troncature.Pour les colonnes string :
showQuotes?: boolean– affiche les valeurs entre guillemets pour les données de type token.Pour les colonnes tag :
tagColorMap?: Record<string, string>– map optionnelle valeur → classe Tailwind (voir ci-dessous).Pour les colonnes tag :
tagItem?(value, row)etonTagClick?(value, row)– libellé, ton, icône et infobulle de chaque tag d'après les données de la ligne, et un clic par tag. Voir Tags d'après les données de la ligne.Pour les colonnes image : les valeurs sont des chaînes URL. Les chemins relatifs d'app comme
/images/table-demo/products/laptop.svg, les URLshttp(s), les URLsblob:et les URLs base64data:image/*sont acceptés. Dans les cellules en lecture seule, survoler une miniature chargée, cliquer dessus ou lui donner le focus au clavier ouvre un aperçu agrandi en React et en Vue, sans configuration supplémentaire. Les cellules d’image modifiables affichent l’aperçu au survol ; un clic ou Entrée continue d’ouvrir l’éditeur d’URL de l’image. Un aperçu ouvert au clavier reste visible quand le pointeur s’éloigne ; changer de contrôle au clavier ou appuyer sur Échap le ferme. Les images vides, invalides ou impossibles à charger conservent l’affichage de remplacement compact.
Redimensionnement des colonnes
Activez le redimensionnement au niveau de la table, puis désactivez-le sur les colonnes qui doivent conserver une largeur fixe :
table: {
enableColumnResizing: true,
},
columns: {
definitions: [
{ id: 'name', type: 'text', header: 'Nom', size: 240, minSize: 140, maxSize: 420 },
{ id: 'status', type: 'tag', header: 'Statut', enableResizing: false },
],
}Le séparateur d'en-tête fonctionne au pointeur, au toucher et au clavier. Les flèches gauche/droite modifient la largeur par pas de 10 pixels, Début applique minSize, Fin applique maxSize et un double-clic restaure size. React et Vue conservent les largeurs obtenues dans l'état URL et les vues enregistrées. Les colonnes virtuelles select et actions ne sont pas redimensionnables.
Calculs de footer par colonne
Vous pouvez préconfigurer les calculs directement sur les colonnes :
{
id: 'price',
type: 'number',
header: 'Price',
defaultCalculation: 'average',
}Valeurs utiles par type :
Tous types :
count_all,count_values,count_unique,count_empty,count_not_empty,percent_empty,percent_not_emptyNumber :
sum,average,median,min,max,rangeDate :
min,max,rangeBoolean :
count_true,count_false,percent_true,percent_false
Si un defaultCalculation n'est pas valide pour le type de colonne, il est ignoré sans crash. Les lecteurs voient les calculs en texte tant qu'ils n'activent pas Éditer les calculs dans les Réglages de la vue ; ajoutez lockCalculation: true pour garder une colonne sur son defaultCalculation.
Édition inline par colonne
Activez table.allowInlineEdit et table.inlineEdit.enabled, fournissez une
action update, puis activez inlineEdit sur chaque colonne concernée :
{
id: 'themes',
type: 'multiSelect',
header: 'Thèmes',
inlineEdit: {
enabled: true,
editor: 'multiSelect',
debounceMs: 700,
options: [
{ label: 'Culture', value: 1 },
{ label: 'Tech', value: 2 },
{ label: 'Archivé', value: 3, disabled: true },
],
},
}inlineEdit.formField permet de cibler un autre champ du catalogue pour la
validation et la clé du payload. inlineEdit.readonly rend la cellule non
modifiable. Les éditeurs disponibles sont auto, text, number, boolean,
date, select, multiSelect, textarea, json et url.
Sélection multiple inline
En React comme en Vue, editor: 'multiSelect' ouvre une liste flottante ancrée à
un champ sur une seule ligne. Les valeurs sélectionnées sont des pastilles
supprimables ; saisir du texte dans le même champ filtre les options par libellé.
La liste ne modifie pas la hauteur de la ligne du tableau. Les flèches parcourent
les options ; Entrée bascule l'option surlignée. Entrée sans option surlignée,
Tab vers l'extérieur du champ ou un clic en dehors enregistre la sélection finale.
Échap abandonne les modifications qui n'ont pas encore été envoyées.
L'enregistrement automatique utilise debounceMs (700 ms par défaut). Avec
table.inlineEdit.showDelayIndicator activé (par défaut), une fine barre indique
le délai puis reste visible pendant la sauvegarde. La fermeture attend la
requête en cours et les changements plus récents. En cas d'échec, le champ, le
brouillon et l'erreur restent disponibles pour réessayer ; une réponse ancienne
ne remplace jamais une sélection plus récente.
Les options désactivées ne peuvent être ni ajoutées ni retirées. Les valeurs
numériques et booléennes conservent leur type dans le payload ; tout retirer
enregistre []. Fermer un champ inchangé ne déclenche aucune mise à jour.
Number column (number)
Les colonnes numériques affichent les valeurs avec un format optionnel et sont alignées à droite (en-tête et cellules) par défaut.
Format d'affichage : numberFormat
Utilisez numberFormat pour contrôler le séparateur de milliers, le séparateur décimal, le nombre de décimales et un préfixe/suffixe monétaire optionnel.
Presets (string) :
'space'– espace comme séparateur de milliers, point pour les décimales (ex.1 234 567.89)'dot'– point pour les milliers, virgule pour les décimales (ex.1.234.567,89)'comma'– virgule pour les milliers, point pour les décimales (ex.1,234,567.89)'locale'– utilise leIntl.NumberFormatdu navigateur (dépend de la locale)
Options explicites (object) :
thousandsSeparator?: string– ex.' ','.',','decimalSeparator?: string– ex.'.',','decimals?: number– nombre fixe de décimales (omettre pour le comportement par défaut)prefix?: string– texte avant le nombre (ex.'€ 'pour une devise)suffix?: string– texte après le nombre (ex.' €'pour les euros)style?: 'decimal' | 'currency' | 'percent' | 'compact' | 'unit'– style Intl ; définircurrencyimplique'currency'currency?: string,currencyDisplay?: 'symbol' | 'narrowSymbol' | 'code' | 'name'– code ISO 4217 comme'EUR'unit?: string,unitDisplay?: 'short' | 'long' | 'narrow'– unité Intl comme'kilogram'locale?: string– remplace la locale du tableau pour cette colonneminimumFractionDigits?,maximumFractionDigits?– décimales bornées (decimalsfixe les deux ;decimalPlacesde Vue est accepté)signDisplay?: 'auto' | 'always' | 'exceptZero' | 'never'negative?: 'minus' | 'parentheses'–'parentheses'affiche(1 234,00), comme en comptabilitépercentBase?: 'fraction' | 'whole'– pourcentage saisi0.25(par défaut) ou25pour 25 %display?: 'number' | 'bar',max?: number– une barre de progression à côté de la valeur, pleine àmax(1 pour les pourcentages en fraction, 100 sinon)
Les séparateurs personnalisés s’appliquent à tous les styles, devises et pourcentages compris.
Exemples :
// Euros, pas de décimales, milliers espacés (ex. 2 499 €)
{
id: 'price',
type: 'number',
header: 'Price',
numberFormat: { thousandsSeparator: ' ', decimals: 0, suffix: ' €' },
}
// Style US avec préfixe
{
id: 'amount',
type: 'number',
header: 'Amount',
numberFormat: { thousandsSeparator: ',', decimalSeparator: '.', decimals: 2, prefix: '$ ' },
}
// Preset uniquement
{ id: 'count', type: 'number', header: 'Count', numberFormat: 'space' }
// Devise selon la locale : €1,234.50, ou 1 234,50 € avec la locale 'fr-FR'
{ id: 'revenue', type: 'number', header: 'Revenue', numberFormat: { currency: 'EUR' } }
// Négatifs comptables : ($1,234.50)
{ id: 'balance', type: 'number', header: 'Balance', numberFormat: { currency: 'USD', negative: 'parentheses' } }
// Barre de progression depuis une valeur entre 0 et 1 : ▰▰▱ 49 %
{ id: 'progress', type: 'number', header: 'Progress', numberFormat: { style: 'percent', display: 'bar' } }
// Format compact et unités : 1.3M, 12 kg
{ id: 'views', type: 'number', header: 'Views', numberFormat: { style: 'compact' } }
{ id: 'weight', type: 'number', header: 'Weight', numberFormat: { style: 'unit', unit: 'kilogram' } }Quand numberFormat n'est pas défini, React affiche les nombres bruts (sans regroupement des milliers) et Vue les regroupe selon la locale ; définissez numberFormat pour un rendu identique dans les deux éditions. Un formatter personnalisé (s'il est fourni lors de la construction programmatique des colonnes) a priorité sur numberFormat.
Presets d'affichage de date
Pour type: 'date', vous pouvez utiliser des presets stricts :
localized-shortlocalized-mediumlocalized-longmonth-name-longmonth-yeardmy-numericdmy-shortmdy-numericmdy-shortiso-dateiso– instant ISO completdate,short,long– dates localisées moyenne, courte et complètedateTime– date et heuretime– heure seulerelative– durée localisée comme « il y a 3 jours » ou “3 days ago”
Les colonnes de date acceptent aussi timeZone (fuseau IANA comme 'Europe/Paris', utilisé par les presets) et hour12 pour imposer une horloge 12 ou 24 heures. Une colonne de date sans timeZone propre prend le table.timeZone de la table, en React et en Vue, si bien que les cellules, les cartes, les pieds de tableau, le Fil et les valeurs des fiches utilisent un seul fuseau, le même sur le serveur et dans le navigateur ; sans l’un ni l’autre, le fuseau de l’environnement d’exécution s’applique. Un motif dateFormat (date-fns) l’emporte sur le preset et utilise l’heure locale. Les valeurs sans heure comme '2026-09-10' sont des jours du calendrier local.
Exemple :
{
id: 'createdAt',
type: 'date',
header: 'Created',
dateDisplayPreset: 'month-name-long',
}Tag column (tag)
Les colonnes tag affichent les valeurs sous forme de badges colorés. Les couleurs sont déterministes : la même valeur de tag reçoit toujours la même couleur entre les sessions et les rechargements de page (dérivée d'un hash de la valeur). Les valeurs sont normalisées (trim + lowercase) pour la correspondance ; par exemple "Urgent" et "urgent" partagent la même couleur.
Couleurs personnalisées par valeur : tagColorMap
Vous pouvez surcharger les couleurs pour des valeurs spécifiques via tagColorMap dans la définition de colonne. Les clés sont les valeurs de tag (la recherche essaie d'abord la valeur brute, puis la valeur normalisée) ; les valeurs sont des classes Tailwind pour le badge (par ex. fond + texte).
Cette option fonctionne directement depuis columns.definitions, sans câblage personnalisé supplémentaire.
Exemple :
{
id: 'status',
type: 'tag',
header: 'Status',
tagColorMap: {
Urgent: 'bg-red-500/80 text-white dark:bg-red-600/90',
Done: 'bg-green-500/80 text-white dark:bg-green-600/90',
'In progress': 'bg-amber-500/80 text-white dark:bg-amber-600/90',
},
}Les entrées définies dans tagColorMap utilisent la classe fournie ; toute autre valeur utilise la couleur déterministe basée sur le hash.
Tags d'après les données de la ligne
Quand un tag dépend de sa ligne plutôt que d'une option fixe (les activations d'un deal, nommées d'après chaque activation et vertes une fois publiées), déclarez tagItem et onTagClick au lieu de dessiner des pastilles dans un cellRenderer. Les valeurs peuvent être des objets.
{
id: "activations",
header: "Activations",
type: "tag",
accessorFn: (row) => row.activations,
tagItem: (activation) => ({
label: activation.name,
tone: activation.postsCount > 0 ? "success" : "neutral",
icon: <Instagram />, // Vue : icon: Instagram
title: activation.account,
}),
onTagClick: (activation, row) => openActivation(row, activation),
}tagItem(value, row)renvoie{ label?, tone?, icon?, title? }pour chaque valeur. Chaque champ se rabat sur le libellé et la couleur de l'option.tonevaut"neutral","info"(depuis la v3.37.0),"success","warning"ou"danger".info,success,warningetdangerteintent le tag avec les variables du thème--yayaw-info,--yayaw-success,--yayaw-warninget--yayaw-danger(le primary du thème, vert, ambre et le destructive du thème par défaut), lisibles en thème clair comme sombre ;neutraldonne le tag atténué. Un ton l'emporte sur lacolorde l'option,tagColorMapet la couleur automatique, et s'affiche même aveccoloredTags: false.icon– un nœud React, ou un composant Vue, dessiné avant le libellé.titleest l'infobulle du tag.onTagClick(value, row)fait de chaque tag un bouton. Ses clics et touches restent sur lui : ils n'ouvrent jamais la ligne, ne lancent pas l'édition inline et ne commencent pas de glisser-déposer. Ajoutez un « + » à côté des tags avec une action de cellule.
Ils s'appliquent dans la grille et dans les cartes Liste, Kanban et Galerie ; les cartes Feed gardent les libellés et couleurs des options.
Colonnes de tags
Une colonne avec tags: true (ou tags: { create?, manage?, bulk? }) contient
des identifiants de tags du catalogue de votre application : une colonne
multiSelect en contient une liste, une colonne select un seul. Avec les
actions facultatives tags, les options de la colonne sont ce catalogue,
chargé une fois par table et par colonne au montage de la table puis mis en
cache, si bien que cellules, cartes, fil, filtres (avec des pastilles de
couleur), regroupements, formulaires et fiche affichent les noms et couleurs
des tags. Sans elles, une colonne de tags garde ses options statiques.
columns: [
{ id: "tags", header: "Tags", type: "multiSelect", tags: true, inlineEdit: true },
],
// getTableActions(tableType)
tags: {
list: ({ tableId, tableType, columnId }) => listTags(columnId), // [{ id, name, color? }]
create: ({ columnId, name, color }) => createTag(columnId, name, color), // le nouveau tag
update: ({ id, name, color }) => updateTag(id, { name, color }), // color: null l'efface
merge: ({ sourceIds, targetId }) => mergeTags(sourceIds, targetId), // réécrit les enregistrements
remove: ({ id }) => deleteTag(id), // et le retire des enregistrements
},| Action | Reçoit, en plus de { tableId, tableType, columnId } | Sans elle |
|---|---|---|
list | rien | Les options statiques de la colonne |
create | name, color? ; répond le nouveau tag | Pas de Créer « nom » |
update | id, name?, color? (null l'efface) | Ni renommage ni changement de couleur |
merge | sourceIds, targetId | Pas de fusion |
remove | id | Pas de suppression |
Les réponses sont des valeurs ou { success, data?, error? }. Les mêmes
actions et options de colonne fonctionnent en React et en Vue.
Sélecteur de tags (cellules en ligne, champs d'une fiche liés à une colonne de tags, fenêtres d'action groupée) : pastilles colorées, recherche insensible à la casse et aux accents, et Créer « nom » avec
create(sauftags: { create: false }), qui crée, sélectionne et met en cache le tag aussitôt. Flèches, Entrée, Retour arrière et Échap y fonctionnent.Ajouter des étiquettes et Retirer des étiquettes dans la barre d'actions groupées (colonnes de listes, avec
allowBulkEditetbulkUpdateouupdate) : les lignes sélectionnées changent aussitôt ; celles qui échouent sont rétablies et restent sélectionnées. Par défaut,bulkUpdate(ids, { [field]: tagIds })reçoit les listes obtenues de chaque groupe de lignes ; avectags: { bulk: "patch" }, il reçoit une seule fois{ [field]: { add, remove } }, que votre serveur applique avecapplyTagPatch().Gérer les étiquettes, dans le menu de la colonne, renomme, recolore, fusionne et supprime les tags ; une suppression indique combien d'enregistrements utilisent le tag (un appel à
aggregategroupé par la colonne).table.canManageTags: falseoutags: { manage: false }le masquent.Couleurs : des noms de la palette (
TAG_COLOR_NAMES) ou n'importe quelle couleur CSS ; un tag sans couleur garde sa teinte automatique, etcoloredTags: falseaffiche des tags neutres.Facettes : une colonne de tags dans
table.facetsliste les noms du catalogue, compte chaque tag une fois par enregistrement et filtre aveccontains.
Les types du contrat et les fonctions utiles (resolveTagColumn,
tagOptions, applyTagPatch, tagUsageRequest…) sont dans
utils/tag-catalog.ts, utilisable côté serveur, dans les deux éditions. Les
libellés des tags existent en anglais et en français, choisis selon la langue
de la table, et lisent les traductions tags.<clé>.
Colonnes de type dynamique
Utilisez type: 'dynamicType' et indiquez typeKey sur la ligne pour choisir le renderer au runtime.
Selection column (select)
La colonne
selectest virtuelle et ne nécessite pas d'entrée dansdefinitions.Ajoutez
'select'àcolumns.orderet àcolumns.visiblepour l'afficher quand vous fournissez une listevisibleexplicite.Contrôlée par
table.enableRowSelection(par défauttrue).Rendue comme une colonne étroite à largeur fixe avec une checkbox centrée ; même largeur que la colonne actions.
Pour la masquer, retirez
'select'decolumns.visible.Elle n'est pas masquable via le menu d'options de l'interface.
Actions de cellule
Une commande à côté d'une valeur (ajouter une note, modifier les contacts, ouvrir la fiche, copier un e-mail) se déclare sur la colonne au lieu d'être dessinée dans un cellRenderer. La table la dessine après la valeur, à la taille de contrôle de la densité courante (16 px en 2XS, 24 px en S, 28 px en M, jusqu'à 44 px en 2XL) et avec la taille de texte de la cellule, dans la grille comme dans les cartes Liste, Kanban et Galerie. Les boutons dessinés dans un cellRenderer gardent leur propre taille et ignorent la densité.
{
id: "note",
header: "Notes",
copyable: true,
cellActions: [
{
id: "notes",
label: "Notes",
icon: <StickyNote />, // Vue : icon: StickyNote
count: (row) => row.notesCount,
onClick: (row) => openNotes(row),
},
{ id: "open", label: "Ouvrir", href: (row) => `/records/${row.id}`, reveal: "hover" },
],
}Chaque action accepte :
id,label– le libellé sert de nom accessible et d'infobulle ; une action sans icône l'affiche en texte.icon?– un nœud React, ou un composant Vue.onClick?(row, value)ouhref?(row)– un lien s'ouvre dans un nouvel onglet et n'appelle jamaisonClick; une action donthrefne renvoie rien est masquée.count?(row)– un nombre affiché à côté de l'icône, masqué à 0.visible?(row),disabled?(row)– masquent l'action, ou l'affichent désactivée.reveal?: "always" | "hover"–hoverl'affiche au survol ou au focus de la cellule, et toujours sur écran tactile (par défaut"always").placement?: "end" | "start"–startdessine l'action avant la valeur, par exemple pour afficher toutes les fiches qui la partagent (par défaut après la valeur). L'action de copie termine toujours la cellule.
copyable: true ajoute en dernier une action de copie, visible au survol, qui affiche « Copié » une fois la valeur dans le presse-papiers. Les listes sont copiées jointes par « , ».
Les clics, doubles clics et touches sur une action restent sur elle : ils n'ouvrent jamais la ligne, ne lancent pas l'édition inline et ne commencent pas de glisser-déposer. Sur une cellule éditable inline, les actions s'affichent avec la valeur et se masquent pendant l'édition.
Actions column (actions)
Ajoutez
{ id: 'actions', type: 'actions', header: '...' }àcolumns.definitions(le libellé d'en-tête n'est pas affiché dans l'UI ; utilisezheader: ''ou n'importe quel libellé pour l'accessibilité/le menu colonne).Rendue comme une colonne étroite à largeur fixe avec un menu d'actions centré (ellipsis) par ligne ; même largeur que la colonne de sélection.
Pour la masquer, retirez
'actions'decolumns.visible.Elle n'est pas masquable via le menu d'options de l'interface.
Voir aussi :
Déclarer le type de donnée une seule fois
Le type et les options d'une colonne déterminent par défaut sa cellule, son éditeur inline, son champ de formulaire généré pour la création, la modification ou l'édition groupée, et ses filtres, dans React comme dans Vue. Les champs standards n'exigent pas de FormConfig correspondant. Activez les actions nécessaires et fournissez leurs handlers ; la bibliothèque génère les contrôles. Un catalogue de formulaires reste une surcharge explicite pour la validation, les permissions, les relations et les mises en page personnalisées.
| Type de colonne | Cellule | Inline / formulaire généré | Filtre |
|---|---|---|---|
text, string | Texte | Saisie de texte | Opérateurs textuels |
code | Texte monospace | Éditeur multiligne | Opérateurs textuels |
number | Nombre formaté | Saisie numérique | Comparaisons et intervalle |
boolean | Indicateur booléen | Contrôle booléen | Choix vrai/faux |
date | Préréglage de date | Saisie de date calendaire | Comparaisons et intervalle calendaires |
url | Lien | Saisie d'URL | Opérateurs textuels |
image | Image avec repli | Saisie de l'URL de l'image | Opérateurs textuels |
json | Valeur structurée | Éditeur JSON | Opérateurs textuels |
location | Nom du lieu, sinon adresse, sinon coordonnées | Recherche d’adresse et coordonnées | Vide, à moins de N km, dans une zone |
select, tag | Libellé d'option | Sélection simple | Opérateurs d'appartenance |
multiSelect | Libellés d'options | Sélection multiple | Appartenance à au moins un, tous ou aucun |
dynamicType | Résolue depuis le typeKey de la ligne | Résolu depuis le même type de ligne | Opérateurs textuels entre types hétérogènes |
custom | Rendu applicatif | Champ de catalogue ou éditeur inline explicite | Opérateurs textuels ou filtre applicatif |
actions | Actions de ligne | Aucun éditeur de donnée | Aucun filtre de donnée |
const columns = [
{ id: "name", header: "Nom", type: "text" },
{ id: "themeIds", header: "Thèmes", type: "multiSelect", options: [
{ label: "Culture", value: 1 },
{ label: "Technologie", value: 2 },
] },
{ id: "metadata", header: "Métadonnées", type: "json" },
{ id: "publishedOn", header: "Date de publication", type: "date" },
];Les options affichent leurs libellés et conservent le type primitif de leurs valeurs : 1 et "1" sont deux choix distincts. Les choix déjà enregistrés mais inconnus et les espaces sont préservés. Une valeur numérique ou une date vidée en inline devient null ; une date modifiée en inline est enregistrée sous la forme YYYY-MM-DD dans les deux versions, comme dans les formulaires générés. Les intégrations React qui attendaient auparavant un objet Date en inline doivent accepter cette chaîne de date dans leur schéma de champ et leur handler de mise à jour.
Un brouillon JSON incomplet reste visible et bloque l'enregistrement jusqu'à sa correction. Les objets, tableaux, chaînes, nombres, booléens et null sont transmis sous forme de valeurs parsées à l'action de mise à jour. Entrée insère une nouvelle ligne dans les éditeurs de code et de JSON ; Ctrl/Cmd+Entrée ou la sortie de l'éditeur valide, et Échap annule le brouillon. Les schémas et les retours d'échec de sauvegarde restent appliqués.
Les colonnes calculées avec accessorFn et les valeurs personnalisées ne reçoivent pas de champ texte généré. Décrivez explicitement leur contrat d'écriture dans un catalogue. Un champ dynamique est exclu du formulaire groupé généré lorsque les lignes sélectionnées n'ont pas le même type. Un catalogue explicite reste prioritaire : un champ omis, masqué ou désactivé ne devient pas éditable du seul fait qu'une colonne existe.
Afficher seulement les champs de stock
Réduisez les colonnes visibles sans retirer les autres propriétés du catalogue. Les utilisateurs peuvent les réactiver dans Propriétés.
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,
columns: {
...productConfig.columns,
visible: ["name", "stock", "status"],
order: ["name", "stock", "status", "price"],
},
});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,
columns: {
...productConfig.columns,
visible: ["name", "stock", "status"],
order: ["name", "stock", "status", "price"],
},
});Ajouter des booléens et des tags
Déclarez les types des valeurs plutôt que de tout convertir en texte. Les données partagées contiennent déjà active et tags.
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,
columns: {
...productConfig.columns,
definitions: [
...productConfig.columns.definitions,
{ id: "active", header: "Active", type: "boolean" },
{
id: "tags",
header: "Tags",
type: "multiSelect",
options: [
{ value: "office", label: "Office" },
{ value: "wood", label: "Wood" },
{ value: "seating", label: "Seating" },
],
},
],
visible: ["name", "active", "tags"],
order: ["name", "active", "tags", "price", "stock", "status"],
},
});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,
columns: {
...productConfig.columns,
definitions: [
...productConfig.columns.definitions,
{ id: "active", header: "Active", type: "boolean" },
{
id: "tags",
header: "Tags",
type: "multiSelect",
options: [
{ value: "office", label: "Office" },
{ value: "wood", label: "Wood" },
{ value: "seating", label: "Seating" },
],
},
],
visible: ["name", "active", "tags"],
order: ["name", "active", "tags", "price", "stock", "status"],
},
});Contrôles de filtre applicatifs
filterRenderer({ value, onChange }) fournit un nœud React ou un VNode Vue
pour une colonne dans le menu natif des filtres, par exemple une plage de dates
ou un sélecteur de relations à distance. Le callback modifie l’état normal du
filtre : vues enregistrées et réinitialisation partagent la même valeur.
Renvoyez undefined ou une chaîne vide pour effacer le filtre. Conservez le type
des identifiants et des booléens. L’application gère les libellés accessibles,
la validation, le chargement, l’annulation et la traduction vers son API.
Cela n’ajoute pas automatiquement le contrôle à la barre de filtres rapides.
Valeurs de date et heure
Définissez withTime: true sur une colonne date (ou un champ de formulaire) qui contient des instants en chaînes ISO 8601. Les cellules affichent la date et l’heure dans la langue (le préréglage dateTime, sauf si la colonne définit son propre préréglage ou motif), et les formulaires et l’édition en ligne utilisent une saisie de date et d’heure dans le timeZone de la colonne (l’éditeur datetime), en enregistrant l’instant en UTC. Le tri compare les instants ; les filtres comparent le jour de l’instant dans ce fuseau, et les exports gardent l’heure.
Montants en plusieurs devises
numberFormat.currencyColumn nomme le champ de la ligne qui contient le code de sa devise (ISO 4217, comme "EUR") ; numberFormat.currency sert de repli. Les cellules et les cartes lisent chaque montant dans la devise de sa ligne, et les calculs de pied de tableau (et les sous-totaux de groupe en React) n’additionnent jamais des devises différentes : ils affichent un total par devise, comme « 1 200,00 € · 300,00 $ ». Pour afficher un seul total converti, définissez numberFormat.currencyConversion: { currency: "EUR", rates: { USD: 0.92 }, display?: "converted" | "both" } (les taux sont des unités de la devise cible par unité de chaque code), avec un rappel convert(amount, from, to) optionnel pour les codes sans taux. Quand une devise ne peut pas être convertie, les totaux par devise restent. Les pieds de tableau calculés sur le serveur reçoivent currencyColumns dans actions.aggregate (voir les actions serveur).
Avatars des colonnes d’image
avatar sur une colonne d’image (true, ou { nameColumn, shape }) affiche des initiales sur une couleur stable quand un enregistrement n’a pas d’image, dans les cellules et les propriétés des cartes. Le nom vient de nameColumn, sinon du name, title ou label de l’enregistrement, et nomme l’avatar pour les lecteurs d’écran.
Personnes en avatars
displayVariant: "avatars" sur une colonne select, multiSelect ou tag affiche ses valeurs comme des personnes au lieu de tags : l’image de chaque option (une photo), ou des initiales sur une couleur stable tirée de son libellé quand elle n’en a pas ou qu’elle ne se charge pas. Plusieurs valeurs se chevauchent ; au-delà de quatre, trois s’affichent et « +N » liste les autres dans son infobulle. Chaque avatar se rejoint au clavier, se lit comme le libellé de l’option et l’affiche dans une infobulle. Les filtres, les éditeurs et les exports gardent les libellés.
{
id: "owners",
header: "Responsables",
type: "multiSelect",
displayVariant: "avatars",
options: [
{ value: 1, label: "Ada Lovelace", image: "/avatars/1.jpg" },
{ value: 2, label: "Grace Hopper" }, // initiales « GH »
],
}Booléens en interrupteurs
displayVariant: "switch" sur une colonne boolean dessine chaque cellule comme un interrupteur au lieu d’une coche ; une valeur vide l’affiche éteint. Avec l’édition en ligne, un clic sur la cellule bascule l’interrupteur et enregistre aussitôt la valeur, et la cellule reste un interrupteur pendant l’enregistrement. Les filtres, le tri et les exports sont ceux de toute colonne booléenne.
{
id: "active",
header: "Actif",
type: "boolean",
displayVariant: "switch",
inlineEdit: true,
}