@starterlib/ui 0.11.7 → 0.13.0

package/virtuel/README.md

@@ -33,6 +33,45 @@ Ce qu'elle n'est pas : une grille editable (`st-data-grid`) ni une liste de tran
 - `allerA(rang)` : amene une ligne dans la fenetre.
 - Hauteur de la fenetre : l'entree `hauteurDeFenetre`, une longueur CSS (`24rem` par defaut).
 
+## `st-virtual-table` (P08-19 d'Aplomb)
+
+Meme condition d'entree, aux volumes de l'echelle : des centaines de milliers de lignes d'un
+journal technique ou d'un audit, affichees ensemble (au MVP, `st-data-table` et la pagination par
+curseur suffisent ; ecran nomme : P13-11).
+
+```html
+<st-virtual-table
+  legende="Journal technique"
+  [colonnes]="colonnes"
+  [lignes]="lignes()"
+  cle="id"
+  [(tri)]="tri"
+  selectionnable
+  libelleDeSelection="Selection"
+  [(selection)]="choisies"
+>
+  <ng-template stCellule="niveau" [stCelluleDe]="lignes()" let-ligne
+    >{{ ligne.niveau }}</ng-template
+  >
+</st-virtual-table>
+```
+
+- Un `<table>` NATIF, pas une grille : `caption` (la `legende`, qui nomme aussi la fenetre),
+  `aria-rowcount` sur la table (lignes et ligne d'en-tete), `aria-rowindex` sur chaque ligne rendue
+  (rang dans le tableau ENTIER), en-tete de ligne `th scope="row"` (la premiere colonne par defaut,
+  `enTeteDeLigne`), en-tete fige en haut de la fenetre.
+- Colonnes : la forme de `ColonneDeTableau` de `st-data-table` (`ColonneVirtuelle` : `cle`,
+  `libelle`, `alignement`, `triable`, `libelleMasque`), redite et non importee : ce point d'entree
+  n'en importe aucun autre. Cellules : `ng-template [stCellule]`, la meme ecriture.
+- Tri PILOTE (`[(tri)]`, `triTernaire`) : un clic emet la demande, `aria-sort` la porte ; les lignes
+  ne sont jamais reordonnees, le serveur le fait.
+- Selection par cle (`selectionnable`, `[(selection)]`, `cle`, `libelleDeSelection`) : une case par
+  ligne, nommee par l'en-tete de sa ligne ; aucune selection globale (elle appartient au serveur).
+- `hauteurDeLigne` FIXE (44 par defaut ; nulle ou negative refusee), `hauteurDeFenetre` (`24rem`),
+  `allerA(rang)`. Au plus soixante lignes dans le document (marges de cinq a dix lignes).
+- Essais : `st-virtual-table.spec.ts` (cent mille lignes, au plus soixante rendues, rang et total,
+  tri pilote, selection par cle, accessibilite) ; banc : cent mille lignes fictives.
+
 ## Gardes et poids
 
 - Point d'entree a lui : il traine `@angular/cdk/scrolling` et RIEN d'autre (`pnpm paquets:check`,