@mostajs/dataviz
v0.3.0
Published
Graphiques HTML/SVG rendus côté serveur (zéro dépendance, aucun script) : tuiles de chiffres clés, barres empilées à 100 %, colonnes, courbe, légende et tableau de données ; palette validée (contraste, daltonismes), une seule échelle par graphique, jamais
Maintainers
Readme
@mostajs/dataviz
Auteur : Dr Hamid MADANI [email protected] · Licence AGPL-3.0-or-later · membre de mosta-ui-html-stack
Des graphiques en HTML/SVG rendus côté serveur, sans dépendance et sans script dans la page : tuiles de chiffres clés, barres empilées à 100 %, colonnes, courbe, légende et tableau de données. Chaque fonction rend une chaîne HTML, à poser dans n'importe quelle page.
La méthode
- La forme d'abord, la couleur en dernier. Un nombre seul est une tuile ; une part d'un tout, une barre empilée ; une grandeur par période, des colonnes ; un cumul, une courbe.
- La couleur suit son rôle. Identité : palette catégorielle dans un ordre fixe, jamais recyclé. États ordonnés ou grandeur : une teinte, du clair au foncé. Alerte : palette de statut, toujours avec un libellé.
- Une seule échelle par graphique. Deux mesures d'échelles différentes font deux graphiques.
- Des marques fines : bout de barre arrondi de 4 px côté valeur, 2 px de vide entre deux segments, trait de 2 px, points de 8 px.
- Le texte garde les encres du texte, jamais la couleur d'une série ; on étiquette le maximum ou la fin, pas chaque point.
- Jamais la couleur seule : légende, infobulle (
<title>) sur chaque marque avec une zone de survol plus large que la marque, description pour les lecteurs d'écran, et le tableau des données replié sous chaque graphique.
Utilisation
import { style, tuiles, barresEmpilees, colonnes, courbe, palette } from '@mostajs/dataviz';
const [clair, moyen, fonce] = palette.ordinale3;
const html = style() // une fois par page
+ tuiles([{ valeur: 42, libelle: 'personnes en formation' }, { valeur: '71 %', libelle: 'prêtes', detail: '30 sur 42' }])
+ barresEmpilees([{ nom: 'Alpha', lien: '/alpha', valeurs: { fini: 12, cours: 3, rien: 1 } }], {
series: [{ cle: 'fini', libelle: 'prêtes', couleur: fonce }, { cle: 'cours', libelle: 'en cours', couleur: moyen }, { cle: 'rien', libelle: 'pas commencées', couleur: clair }],
part: 'fini', unite: 'personnes' })
+ colonnes([{ etiquette: '03/11', valeur: 18, infobulle: 'semaine du 03/11 : 18 relevés' }], { titre: 'Relevés par semaine' })
+ courbe([{ etiquette: '03/11', valeur: 4 }], { titre: 'Personnes prêtes, en cumul' });API
| fonction | rend |
|---|---|
| style() | le <style> des graphiques (préfixe mdv-), une fois par page ; encres et bordures réglables par --mdv-trait, --mdv-carte, --mdv-encre, --mdv-doux |
| tuiles([{ valeur, libelle, detail? }]) | une grille de tuiles de chiffres clés |
| barresEmpilees(lignes, { series, part?, unite?, seuilEtiquette? }) | une barre à 100 % par entité, la part d'une série à droite, légende et tableau |
| colonnes(points, { couleur?, titre? }) | des colonnes, une seule série ; le maximum porte son nombre |
| courbe(points, { couleur?, titre? }) | une courbe, une seule série ; la dernière valeur porte son nombre |
| gantt(lignes, { titre? }) | Gantt calendaire : une barre par tâche de debut à fin, part faite en plein, graduations mensuelles, tableau (0.2.0) |
| legende(series), tableau(entetes, rangs, { resume?, deplie? }) | les pièces, seules ; deplie: true rend le tableau sans repli, pour l'impression (0.2.0) |
| palette | categorielle (8), bleu (rampe 100→700), ordinale3, statut, et le fond et les encres supposés |
| echelle(max), contraste(a, b), luminance(hex), encreSur(hex), esc(s) | les outils |
points : [{ etiquette, valeur, infobulle? }]. lignes : [{ nom, lien?, valeurs: { [cle]: nombre } }].
Palette
Les valeurs fournies sont validées sur fond clair : contraste, séparation sous les trois daltonismes pour les séries
voisines, écart en vision normale. La rampe ordinale3 (bleu 250 / 450 / 600) garde 2:1 sur le blanc pour son pas le
plus clair. Une application qui change de palette doit refaire cette validation. Le mode sombre n'est pas fourni.
Essais
npm test — test-scripts/unit/dataviz.test.mjs (@mostajs/mjs-unit).
