¿Qué hace dataviz?
Un gráfico es la respuesta a una pregunta. Si no puedes expresar la pregunta en una oración, no puedes elegir el gráfico, y un gráfico que no responde nada es decoración con números.
Aspecto de un buen gráfico
- Una pregunta por gráfico. El título es la pregunta, o su respuesta. "Carreras por mes", no "Analíticas".
- El tipo sigue a la pregunta. Tendencia es una línea, comparación son barras, proporción es una barra apilada, un objetivo único es una barra de progreso, una clasificación es una lista con barras delgadas.
- Un acento. La cosa importante lo recibe. Todo lo demás son pasos neutros de una misma rampa. Nunca un arcoíris dentro de una serie.
- Línea base cero para todo lo que tenga área. Barras y barras apiladas siempre empiezan en cero. Una línea puede empezar en otro valor si el truncamiento es visible y está indicado.
- Cromo suave. Cuadrícula, ejes y etiquetas son discretos. El único dato que resalta son los datos, y solo una serie de ellos es llamativa.
- Números legibles. Unidades en la etiqueta, un formato,
tabular-nums, sin decimales finales que mientan sobre la precisión.
Ejecútalo
- Escribe la pregunta. Una oración: ¿qué decisión ayuda a tomar este gráfico? Si es "muestra los datos", córtalo o conviértelo en una tabla.
- Elige el tipo de references/charts.md. También nombra el gráfico que parece correcto y está mal, que suele ser una dona.
- Da forma a las filas. Una tabla, una fila por categoría, una columna por serie, números ya en la unidad que se mostrará. CSV o JSON, nada pre-agregado dos veces.
- Constrúyelo.
- Ruta rápida:
node <carpeta de la habilidad>/scripts/chart.mjs data.csv --type line --title "Carreras por mes" --unit carreras --accent "#e0a458" --out chart.svg - Tipos:
line,bar,stacked,sparkline,progress. Opciones:--width --height --theme dark|light --subtitle --xlabel --ylabel --decimals --max. - Escribe SVG independiente con
role="img", un<title>, un<desc>, etiquetas mono tabulares y una cuadrícula suave. Insértalo en la página tal cual, o incrústalo en línea para estilizarlo con los tokens de la página. - Construcción manual cuando el gráfico deba vivir dentro de un componente: las recetas en references/charts.md son SVG y CSS simples, sin dependencias.
- Ruta rápida:
- Revísalo con la lista de verificación a continuación, al tamaño en que realmente se verá. Un gráfico legible a 720 de ancho no es legible a 280.
Reglas que no son cuestión de gusto
- Sin librería de gráficos para un gráfico simple. Cuatro barras y una línea son 30 líneas de SVG. Una librería cuesta de 40 a 120 KB, trae estilos por defecto que hay que deshacer, y normalmente incluye un canvas que los lectores de pantalla no pueden leer.
- No codifiques una serie en muchos colores. Un acento, una serie que lidera. Más de tres series en un gráfico significa dos gráficos, o una tabla.
- El color nunca es la única señal. Etiquetas directas, posición o una diferencia de forma. Un gráfico que falla en escala de grises falla para uno de cada doce hombres.
- El texto es texto real. SVG
<text>, no trazados, para que escale con la configuración del lector. Sin etiquetas incrustadas en una imagen. - Respeta el contenedor.
viewBoxmáswidth:100%,height:auto, unmax-width, y unmin-widthdonde las etiquetas dejen de caber. Menos marcas y menos barras a 375 de ancho, no un gráfico encogido. - Sin datos falsos. Si los números son provisionales, el gráfico lo indica junto al título y el informe lo lista.
[necesita: recuento real de ejecuciones]es mejor que una ficción plausible. - Unidades y comparaciones. "47 carreras" o "$48,210", nunca "47". Un cambio siempre lleva con qué se compara: "+12% vs el mes pasado".
- Los gráficos tienen jerarquía. Un gráfico principal por pantalla, claramente el más grande. Un segundo gráfico del mismo tamaño significa que ninguno es el punto.
Lista de verificación
- El gráfico responde a una pregunta con nombre, y el título lo indica
- El tipo coincide con la pregunta; sin dona, sin pastel con seis porciones, sin 3D, sin ejes duales
- Las barras y barras apiladas empiezan en cero; cualquier línea truncada lo indica
- Un acento en la serie o punto que importa; todo lo demás neutro
- Más de tres series divididas en dos gráficos o una tabla
- Cuadrícula y ejes suaves, sin borde del gráfico, sin sombra
- Etiquetas en mono, cifras tabulares, un formato numérico, unidades presentes
- Leyenda presente cuando hay más de una serie, y no necesaria cuando hay una
- Cada figura tiene su comparación donde se muestra un cambio
-
role="img",<title>y<desc>dicen lo que muestra el gráfico, en palabras - Legible a 375 de ancho y al 200 por ciento de zoom; nada recortado, sin colisiones de etiquetas
- Funciona en escala de grises; el color no es la única diferencia entre series
- Los datos provisionales están marcados en la página y listados en el informe
- Los números se remontan a una fuente que puedes nombrar
Tabla de tipos de gráfico, las opciones incorrectas pero comunes, y las recetas SVG y CSS hechas a mano: references/charts.md.