numberFormat

L’apparence des nombres d’une colonne number.

Type	NumberFormatSpec
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

Ses clés sont celles du format de nombre du navigateur : style ('decimal', 'percent', 'currency'), currency ('EUR'), minimumFractionDigits, maximumFractionDigits et useGrouping. Les chiffres et les séparateurs suivent la locale et les numerals de la grille. Sans décimales données (et hors devise), un nombre montre jusqu’à 15 chiffres significatifs : 0.1 + 0.2 affiche 0,3. Un pourcentage multiplie par 100 : 0.25 affiche 25 %.

Il ne change que ce qu’affiche la cellule : le tri et le filtre utilisent le nombre lui-même.

Exemple

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

type Fund = { id: string; name: string; price: number; change: number };

createGrid<Fund>(document.getElementById('fonds')!, {
  rows: [{ id: 'f1', name: 'Vallée verte', price: 1234.5, change: 0.042 }],
  columns: [
    { id: 'name', header: 'Fonds' },
    { id: 'price', header: 'Prix', type: 'number', numberFormat: { style: 'currency', currency: 'EUR' } },
    { id: 'change', header: 'Variation', type: 'number', numberFormat: { style: 'percent', maximumFractionDigits: 1 } },
  ],
  getRowId: (r) => r.id,
  messages: FR,
});

Démo

Voir aussi

• type, align.
• locale.