Que fait dataviz ?
Un graphique est la réponse à une question. Si vous ne pouvez pas formuler la question en une phrase, vous ne pouvez pas choisir le graphique, et un graphique qui ne répond à rien n'est qu'une décoration avec des chiffres.
À quoi ressemble un bon graphique
- Une question par graphique. Le titre est la question, ou sa réponse. « Courses par mois », pas « Analytics ».
- Le type suit la question. Une tendance est une ligne, une comparaison est des barres, une part est une barre empilée, un objectif unique est une barre de progression, un classement est une liste avec des barres fines.
- Un accent. La chose importante reçoit l'accent. Tout le reste est des nuances neutres d'une même gamme. Jamais un arc-en-ciel à l'intérieur d'une seule série.
- Base zéro pour tout ce qui a une surface. Les barres et les barres empilées commencent toujours à zéro. Une ligne peut commencer ailleurs si la troncature est visible et indiquée.
- Chromatisme discret. La grille, les axes et les étiquettes sont discrets. Les seules données qui ressortent sont les données, et une seule série est mise en avant.
- Des chiffres lisibles. Unités dans l'étiquette, un seul format,
tabular-nums, pas de décimales trompeuses sur la précision.
Exécution
- Écrivez la question. Une phrase : quelle décision ce graphique aide-t-il à prendre ? Si c'est « afficher les données », supprimez-le ou transformez-le en tableau.
- Choisissez le type dans references/charts.md. Il nomme également le graphique qui semble correct mais qui est erroné, généralement un donut.
- Façonnez les lignes. Un tableau, une ligne par catégorie, une colonne par série, les nombres déjà dans l'unité à afficher. CSV ou JSON, rien de pré-agrégé deux fois.
- Construisez-le.
- Chemin rapide :
node <dossier de compétence>/scripts/chart.mjs data.csv --type line --title "Courses par mois" --unit courses --accent "#e0a458" --out chart.svg - Types :
line,bar,stacked,sparkline,progress. Options :--width --height --theme dark|light --subtitle --xlabel --ylabel --decimals --max. - Il génère un SVG autonome avec
role="img", un<title>, un<desc>, des étiquettes monospaces à chiffres tabulaires et une grille discrète. Insérez-le tel quel dans la page, ou intégrez-le en ligne pour le styliser avec les tokens de la page. - Construction manuelle lorsque le graphique doit vivre dans un composant : les recettes dans references/charts.md sont en SVG et CSS purs, sans dépendance.
- Chemin rapide :
- Vérifiez-le par rapport à la liste de contrôle ci-dessous, à la taille réelle où il sera vu. Un graphique lisible à 720 de large ne l'est pas à 280.
Règles qui ne sont pas une question de goût
- Pas de bibliothèque de graphiques pour un graphique simple. Quatre barres et une ligne représentent 30 lignes de SVG. Une bibliothèque pèse 40 à 120 Ko, apporte un style par défaut à annuler, et livre généralement un canvas que les lecteurs d'écran ne peuvent pas lire.
- N'encodez pas une série avec plusieurs couleurs. Un accent, une série principale. Plus de trois séries dans un graphique signifient deux graphiques, ou un tableau.
- La couleur n'est jamais le seul signal. Des étiquettes directes, la position ou une différence de forme. Un graphique qui échoue en niveaux de gris échoue pour un homme sur douze.
- Le texte est du vrai texte.
<text>SVG, pas des chemins, pour qu'il s'adapte aux réglages du lecteur. Pas d'étiquettes intégrées dans une image. - Respectez le conteneur.
viewBoxpluswidth:100%,height:auto, unmax-width, et unmin-widthoù les étiquettes cessent de tenir. Moins de graduations et moins de barres à 375 de large, pas un graphique rétréci. - Pas de fausses données. Si les chiffres sont des espaces réservés, le graphique l'indique à côté du titre et le rapport le mentionne.
[besoin : nombre réel de courses]vaut mieux qu'une fiction plausible. - Unités et comparaisons. « 47 courses » ou « 48 210 $ », jamais « 47 ». Un changement indique toujours à quoi il se compare : « +12 % vs mois dernier ».
- Les graphiques ont une hiérarchie. Un graphique principal par écran, clairement le plus grand. Un deuxième graphique de la même taille signifie qu'aucun des deux n'est le point central.
Liste de contrôle
- Le graphique répond à une question nommée, et le titre le dit
- Le type correspond à la question ; pas de donut, pas de camembert à six parts, pas de 3D, pas de doubles axes
- Les barres et les barres empilées commencent à zéro ; toute ligne tronquée l'indique
- Un seul accent sur la série ou le point important ; tout le reste est neutre
- Plus de trois séries réparties en deux graphiques ou un tableau
- Grille et axes discrets, pas de bordure de graphique, pas d'ombre portée
- Étiquettes en police monospace, chiffres tabulaires, un seul format de nombre, unités présentes
- Légende présente quand il y a plus d'une série, et non nécessaire quand il y en a une
- Chaque figure a sa comparaison lorsqu'un changement est affiché
-
role="img",<title>et<desc>indiquent ce que montre le graphique, en mots - Lisible à 375 de large et à 200 % de zoom ; rien n'est coupé, pas de collisions d'étiquettes
- Fonctionne en niveaux de gris ; la couleur n'est pas la seule différence entre les séries
- Les données d'espace réservé sont marquées dans la page et listées dans le rapport
- Les chiffres proviennent d'une source que vous pouvez nommer
Tableau des types de graphiques, les choix erronés mais courants, et les recettes SVG et CSS construites à la main : references/charts.md.