@amsom-habitat/amsom-table 4.3.13 → 4.5.0

package/README.md

@@ -8,7 +8,110 @@ Il regroupe les packages :
 
 ## Nouvelles fonctionnalités
 
-### Menu contextuel (v2.x)
+### 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 :
+
+- **Recherche flexible** : Définissez votre propre logique de filtrage par colonne
+- **Cas d'usage** : Filtrer par libellé quand la colonne affiche un ID
+- **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">
+  <!-- vos templates -->
+</amsom-table-draggable>
+```
+
+**Exemple de configuration :**
+
+```javascript
+const columns = [
+  {
+    id: 'userId',
+    libelle: 'Utilisateur',
+    show: true,
+    customSearch: (item, searchTerm) => {
+      // Filtrer par le libellé de l'utilisateur au lieu de l'ID
+      return normalize(item.userLibelle).includes(normalize(searchTerm))
+    }
+  }
+]
+```
+
+### Menu contextuel (v4.3.x)
 
 Le composant `AmsomTableDraggable` supporte maintenant les menus contextuels :