@amsom-habitat/amsom-table 4.4.0 → 4.5.1

package/README.md

@@ -8,6 +8,79 @@ Il regroupe les packages :
 
 ## Nouvelles fonctionnalités
 
+### Formatage des données (v4.5.x)
+
+Le composant `AmsomTableDraggable` supporte maintenant le formatage automatique et personnalisé des valeurs :
+
+#### Formatter personnalisé
+
+Définissez une fonction de formatage pour chaque colonne :
+
+```javascript
+const columns = [
+  {
+    id: 'price',
+    libelle: 'Prix',
+    show: true,
+    formatter: (value, item) => {
+      // Formater le prix en euros
+      return value ? `${value.toFixed(2)} €` : '-'
+    }
+  },
+  {
+    id: 'fullName',
+    libelle: 'Nom complet',
+    show: true,
+    formatter: (value, item) => {
+      // Combiner plusieurs champs
+      return `${item.firstName} ${item.lastName}`.toUpperCase()
+    }
+  }
+]
+```
+
+**Paramètres du formatter :**
+
+- `value` : La valeur brute de la cellule (item[columnId])
+- `item` : L'objet complet de la ligne (pour accéder à d'autres propriétés)
+
+#### Type de données prédéfini
+
+Utilisez `type` pour appliquer automatiquement un formatage standard :
+
+```javascript
+const columns = [
+  {
+    id: 'createdAt',
+    libelle: 'Date de création',
+    show: true,
+    type: 'unixDate' // Formate timestamp Unix en DD/MM/YYYY
+  },
+  {
+    id: 'lastUpdate',
+    libelle: 'Dernière modification',
+    show: true,
+    type: 'unixDateTime' // Formate en DD/MM/YYYY HH:mm
+  },
+  {
+    id: 'amount',
+    libelle: 'Montant',
+    show: true,
+    type: 'currency' // Formate en euros (1234.56 → 1 234,56 €)
+  }
+]
+```
+
+**Types disponibles :**
+
+- `unixDate` : Timestamp Unix → format date (DD/MM/YYYY)
+- `unixDateTime` : Timestamp Unix → format date et heure (DD/MM/YYYY HH:mm)
+- `currency` : Nombre → format devise euro (1 234,56 €)
+
+**Ordre de priorité :** Si `formatter` et `type` sont définis, `formatter` est prioritaire.
+
+**Note :** Le formatage s'applique à l'affichage ET à la recherche (sauf si `customSearch` est défini).
+
 ### Custom Search (v4.4.x)
 
 Le composant `AmsomTableDraggable` supporte maintenant les fonctions de recherche personnalisées par colonne :
@@ -17,16 +90,13 @@ Le composant `AmsomTableDraggable` supporte maintenant les fonctions de recherch
 - **Compatible avec recherche standard** : Le customSearch complète la recherche par défaut
 
 ```vue
-<amsom-table-draggable
-  :default-columns="columns"
-  :td-items-list="data"
-  :search="searchTerm"
->
+<amsom-table-draggable :default-columns="columns" :td-items-list="data" :search="searchTerm">
   <!-- vos templates -->
 </amsom-table-draggable>
 ```
 
 **Exemple de configuration :**
+
 ```javascript
 const columns = [
   {