field

L’endroit de la ligne où la colonne lit sa valeur, quand ce n’est pas la propriété nommée par son id.

Type	string
Par défaut	l’id de la colonne, sauf si value est donné
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 chemin à points : 'author.name' lit row.author.name. Seules les propriétés propres de la ligne sont lues : une ligne qui est une instance de classe avec des accesseurs demande plutôt une fonction value. Une étape absente donne une cellule vide, jamais une erreur.

Un chemin avec une étape vide ('a..b') ou une clé de prototype (__proto__, constructor, prototype) est refusé avec une erreur invalid-field-path, et la colonne est écartée. Quand la colonne a une value, field n’est pas lu.

Exemple

import { createGrid } from '@dzgrid/dom';
import { FR } from '@dzgrid/dom/locales/fr';

type Book = { id: string; title: string; author: { name: string; born: number } };

createGrid<Book>(document.getElementById('livres')!, {
  rows: [{ id: 'b1', title: 'La Route du sel', author: { name: 'Ines Calloway', born: 1961 } }],
  columns: [
    { id: 'title', header: 'Titre' },
    { id: 'author', header: 'Autrice', field: 'author.name' },
    { id: 'born', header: 'Née en', type: 'number', field: 'author.born' },
  ],
  getRowId: (r) => r.id,
  messages: FR,
});

Voir aussi

• id, value.
• Colonnes.