# Grilles modernes automatiques (toutes les grilles index)

## Demande

Appliquer à toutes les grilles `*/index.blade.php` l'habillage déjà fait à la main sur les grilles clients, commandes, devis, formules, factures et incidents : carte, barre (lignes, recherche, Colonnes, Excel), vrais noms de colonnes, filtres par colonne, choix des colonnes, corbeille au survol pour supprimer.

## Choix

Environ 110 grilles sont concernées, dont une grande majorité de tables de paramètres bâties sur le même modèle. Plutôt que de recopier ~150 lignes de JS et de CSS dans chaque vue, la mise à niveau est faite **une seule fois, au chargement de la grille**, sur le principe de l'habillage global (`docs/habillage_moderne.md`). Elle ne concerne que les utilisateurs du nouveau menu (`body.design-moderne`). Les vues ne sont pas modifiées.

## Fichiers

- `public/inc/js/grille_moderne.js` (nouveau) : remplace `$.fn.DataTable` par une version qui retouche les options et l'en-tête avant l'initialisation, puis ajoute filtres et volet après. Les propriétés statiques de DataTables (`defaults`, `ext`, `isDataTable`…) sont recopiées.
- `resources/views/base.blade.php` : charge le script après `bas.inc.php` (donc après DataTables) et avant l'exécution des scripts de page au chargement (`$(function…)`). Le paramètre `?v=` (date du fichier) évite le cache navigateur.
- `public/inc/css/style.css` : règles communes `.grille-carte` (barre, pied, filtres, corbeille `.corbeille-survol`, volet `.grille-colonnes-volet`, chevron `td.details-control`), et haut de page (`.grille-filtres-auto`, `.grille-titre .grille-actions`, compteurs).

## Grilles concernées

Un `DataTable(...)` appelé sur une table avec un `id` qui remplit toutes ces conditions :

- elle est dans `#block_droite` ;
- elle n'est pas dans une fiche ou une fenêtre (`[id^="affiche_"]`, `.modal`, `form`) ;
- elle n'est pas déjà habillée (`.grille-carte` : clients, commandes, devis, formules, factures, incidents) ;
- elle n'a pas la classe `sans-grille-moderne`, qui permet d'exclure une grille.

Les appels sur une grille déjà initialisée, qui ne font que récupérer son API, gardent le comportement d'origine.

Exemples exclus d'office :

- tableaux de détail du KPI (fenêtres modales) ;
- grille des chantiers dans la fiche client ;
- grilles des fiches annexes.

## Ce qui est fait sur chaque grille

- **Carte** : la `div.table-responsive` devient `.grille-carte.dt-moderne`, sinon une carte est créée autour de la table. Les classes `table-striped` et `table-bordered` et le fond vert inline de l'en-tête sont retirés.
- **Barre et pied** : `dom: '<"grille-barre"lfB>rt<"grille-pied"ip>'`.
  - libellés français : « _MENU_ lignes », « Rechercher… », « début – fin sur N », « Aucune ligne », pagination ‹ › ;
  - `lengthMenu` 10 / 25 / 50 / 100 / Tout si la page n'en a pas. Le nombre de lignes par défaut de la page est gardé.
- **Titres** : un titre entièrement en majuscules est réécrit en minuscules avec majuscule initiale et accents usuels (dictionnaire `ACCENTS` : « LIBELLE » → « Libellé », « CL RESISTANCE » → « Cl résistance »). Les sigles sont gardés (TVA, PDF, CP, BL, SIRET…). Un titre déjà en casse mixte n'est pas touché.
- **Supprimer** : la colonne dont le titre est SUPPRIMER (ou SUPP) perd son titre. Son contenu (croix rouge) est remplacé par une corbeille grise visible au survol de la ligne, rouge au survol. Elle n'est ni triable ni filtrable. La classe de la cellule posée par la page (`supprimer_tva`…) est gardée, donc le clic et la confirmation de la page fonctionnent sans changement.
- **Filtres par colonne** : une ligne de champs (`input.grille-filtre-colonne`) est ajoutée sous les titres, sauf sur les colonnes sans titre, les cases à cocher et Supprimer. Le filtrage est local, 300 ms après la frappe.
  - L'ancienne ligne `.filterhead` (remplie en `initComplete`) est supprimée. Son handler (`.column_search`, colonne trouvée par position) ne trouve donc plus de champ et ne peut plus filtrer la mauvaise colonne quand des colonnes sont masquées.
  - Pas de filtres pour les grilles `serverSide` (le serveur ne gère pas les filtres par colonne).
- **Choix des colonnes** : bouton « Colonnes (n/total) » en tête des boutons, volet de cases à droite sous la barre.
  - La première colonne et Supprimer sont toujours affichées.
  - Le choix est mémorisé par titre dans le navigateur (clé `grille_colonnes:<chemin>:<id table>`). « Toutes les colonnes » réinitialise.
  - Masquer une colonne vide son filtre.
  - Les cases du volet n'ont pas la classe `form-check-input`, que des pages écoutent pour recharger leur grille.
- **Excel** : bouton avec icône, export des seules colonnes affichées sans Supprimer, sauf si la page fixe déjà ses colonnes d'export.
- **Compteur** : si la page a un seul `span.badge` (le « Nombre de … »), il suit les filtres (lignes filtrées).
- **Détail (+)** : chevron au lieu de l'image de fond, comme pour les devis et les commandes.

## Haut de page (titre, compteurs, critères, boutons)

Fait par `haut_de_page()` dans le même script, au chargement, avant les scripts des pages. Ne concerne que les pages qui ont une grille principale et pas encore de `.grille-titre` (les pages refaites à la main ne sont pas touchées). Les éléments sont **déplacés, pas recréés** : identifiants, classes et événements des pages restent valables.

- **Titre** : le bandeau `alert-success` (« LISTE DES TVAs ») devient `.titre-feuille.grille-titre` avec un `h2` en minuscules accentuées (« Liste des TVAs »). Un `.titre-feuille` existant (BL, incidents…) reçoit seulement `grille-titre`.
- **Compteurs** à droite du titre, en cartouches `.grille-compteur` :
  - « Nombre de(s) produit(s) : `<span class="badge">` » → libellé « Nombre de produits » au-dessus du chiffre. Le `span.badge` est gardé (les pages le remplissent par `$('.badge')`) ;
  - « `p.count-text` + `h2.count-title` » (BL : Nombre de BL, M3, Qté moyenne) → un cartouche chacun, `h2` gardé avec son id.
- **Boutons** : Rafraichir (`#rafraichir`, `.refrech`, texte Rafraichir/Actualiser) puis Ajouter (texte Ajouter ou classe `ajouter_*`), où qu'ils soient dans les critères, plus les boutons isolés au niveau de la page (État des connexions…), en `btn-sm` dans `.grille-actions` :
  - à droite du bloc des critères s'il y en a ;
  - sinon à droite du titre, après les compteurs.
  Les cellules qui ne contenaient que ces boutons (avec un libellé vide) sont retirées.
- **Critères** : les blocs qui contiennent des champs sont regroupés dans `.grille-filtres.grille-filtres-auto`.
  - Les `.row` / `.form-row` / `form`, et les blocs qui regroupent plusieurs champs, sont « aplatis » (`display: contents`, classe `grille-filtres-aplati`) pour que tous les champs s'enroulent sur une même ligne.
  - Colonnes Bootstrap neutralisées (largeur, marges et décalages en ligne).
  - Libellés courts au-dessus, sans « : » ni gras ; champs en `form-control-sm`, largeur 130 à 240 px.
  - `#filtre`, `#affiche_*` et les fenêtres ne sont pas déplacés.
- **Balise mal fermée** : si les critères et les boutons sont dans le même bloc que la grille (div non fermée), ce qui précède la grille dans ce bloc est aussi traité. C'était le cas de la grille des produits : sa `div.col-md-12.row` a aussi été refermée dans `produit/index.blade.php`.
- **Pages laissées telles quelles** (trop particulières) : zone au-dessus de la grille contenant un tableau, un graphique, des onglets, une `.card`, une `iframe`, ou plus de 30 champs.

## Limites connues

- Le dictionnaire d'accents ne couvre que les mots courants. Un mot absent reste sans accent : l'ajouter dans `ACCENTS`.
- Haut de page : une page dont un script repère ses champs par leur position ou par leur conteneur Bootstrap (`.form-row`, `.col-md-3`…) pourrait ne plus les trouver. Aucune page index ne le fait à ce jour (vérifié par recherche). Une cellule qui mêle libellé, champ et boutons garde ses boutons sous le champ.
- Une couleur posée par position de cellule (`td:eq(n)`) serait décalée si on masque des colonnes. Aucune grille index n'en utilise à ce jour.

## Vérification

Script analysé sans erreur de syntaxe (JScript), vues compilées. **Non vérifié dans le navigateur** (extension Chrome non connectée) : à contrôler sur quelques grilles (une table de paramètres comme TVA, BL, pesée, mailing, téléchargement).
