O que dataviz faz?
Um gráfico é a resposta para uma pergunta. Se você não consegue formular a pergunta em uma frase, não consegue escolher o gráfico, e um gráfico que não responde nada é decoração com números.
Como é um bom gráfico
- Uma pergunta por gráfico. O título é a pergunta, ou sua resposta. "Execuções por mês", não "Analytics".
- O tipo segue a pergunta. Tendência é linha, comparação é barras, participação é uma barra empilhada, uma única meta é uma barra de progresso, uma classificação é uma lista com barras finas.
- Um acento. A coisa que importa ganha destaque. Todo o resto são tons neutros de uma mesma rampa. Nunca um arco-íris dentro de uma série.
- Linha de base zero para tudo que tem área. Barras e barras empilhadas começam em zero, sempre. Uma linha pode começar em outro lugar se o truncamento for visível e declarado.
- Cromática suave. Grade, eixos e rótulos são discretos. O dado é a única coisa que se destaca, e apenas uma série dele se destaca.
- Números legíveis. Unidades no rótulo, um formato,
tabular-nums, sem decimais extras que mentem sobre a precisão.
Como executar
- Escreva a pergunta. Uma frase: que decisão este gráfico ajuda alguém a tomar? Se for "mostrar os dados", corte ou transforme em tabela.
- Escolha o tipo em references/charts.md. Lá também está nomeado o gráfico que parece certo mas está errado, geralmente um donut.
- Modele as linhas. Uma tabela, uma linha por categoria, uma coluna por série, números já na unidade a ser exibida. CSV ou JSON, nada pré-agregado duas vezes.
- Construa.
- Caminho rápido:
node <pasta do skill>/scripts/chart.mjs data.csv --type line --title "Execuções por mês" --unit execuções --accent "#e0a458" --out chart.svg - Tipos:
line,bar,stacked,sparkline,progress. Opções:--width --height --theme dark|light --subtitle --xlabel --ylabel --decimals --max. - Ele escreve SVG autônomo com
role="img", um<title>, um<desc>, rótulos mono tabulares e uma grade suave. Insira na página como está, ou faça inline para estilizar com os tokens da página. - Construção manual quando o gráfico precisa viver dentro de um componente: as receitas em references/charts.md são SVG e CSS puros, sem dependência.
- Caminho rápido:
- Verifique conforme a lista de verificação abaixo, no tamanho em que será realmente visto. Um gráfico legível a 720 de largura não é legível a 280.
Regras que não são questão de gosto
- Nenhuma biblioteca de gráficos para um gráfico simples. Quatro barras e uma linha são 30 linhas de SVG. Uma biblioteca custa 40 a 120 KB, traz estilos padrão que precisam ser desfeitos e geralmente usa um canvas que leitores de tela não conseguem ler.
- Não codifique uma série em muitas cores. Um acento, uma série que lidera. Mais de três séries em um gráfico significa dois gráficos, ou uma tabela.
- Cor nunca é o único sinal. Rótulos diretos, posição ou diferença de forma. Um gráfico que falha em escala de cinza falha para um em cada doze homens.
- Texto é texto real.
<text>SVG, não caminhos, para que escale com as configurações do leitor. Sem rótulos embutidos em uma imagem. - Respeite o contêiner.
viewBoxmaiswidth:100%,height:auto, ummax-widthe ummin-widthonde os rótulos param de caber. Menos marcas e menos barras a 375 de largura, não um gráfico encolhido. - Sem dados falsos. Se os números são placeholders, o gráfico avisa ao lado do título e o relatório lista.
[precisa: contagem real de execuções]vence uma ficção plausível. - Unidades e comparações. "47 execuções" ou "$48.210", nunca "47". Uma mudança sempre carrega com o que compara: "+12% vs mês passado".
- Gráficos têm hierarquia. Um gráfico principal por tela, claramente o maior. Um segundo gráfico do mesmo tamanho significa que nenhum deles é o ponto central.
Lista de verificação
- O gráfico responde a uma pergunta nomeada, e o título diz isso
- O tipo corresponde à pergunta; sem donut, sem pizza com seis fatias, sem 3D, sem eixos duplos
- Barras e barras empilhadas começam em zero; qualquer linha truncada diz isso
- Um acento na série ou ponto que importa; todo o resto neutro
- Mais de três séries divididas em dois gráficos ou uma tabela
- Grade e eixo suaves, sem borda do gráfico, sem sombra projetada
- Rótulos em mono, figuras tabulares, um formato de número, unidades presentes
- Legenda presente quando há mais de uma série, e não necessária quando há apenas uma
- Cada figura tem sua comparação onde uma mudança é exibida
-
role="img",<title>e<desc>dizem o que o gráfico mostra, em palavras - Legível a 375 de largura e a 200 por cento de zoom; nada cortado, sem colisões de rótulos
- Funciona em escala de cinza; cor não é a única diferença entre séries
- Dados placeholder estão marcados na página e listados no relatório
- Os números rastreiam para uma fonte que você pode nomear
Tabela de tipos de gráfico, as escolhas erradas mas comuns, e as receitas de SVG e CSS manuais: references/charts.md.