O que D3.js faz?
Visão Geral
D3.js é uma biblioteca JavaScript de baixo nível para construir visualizações de dados interativas e personalizadas, vinculando dados a elementos DOM. Ela fornece escalas, eixos, geradores de formas, projeções geográficas, simulações de força e layouts hierárquicos, dando aos desenvolvedores controle total sobre a saída visual, enquanto se integra com React por meio de escalas e layouts computados.
Instruções
- Ao vincular dados, use
.data(dataset).join("element")(D3 v6+) para o padrão enter/update/exit, definindo atributos e estilos a partir dos dados vinculados por meio de funções de acesso. - Ao criar escalas, escolha o tipo apropriado (
scaleLinearpara contínuo,scaleBandpara barras categóricas,scaleTimepara datas,scaleOrdinalpara mapeamento de cores) e sempre defina o domínio a partir dos dados usandod3.extent(). - Ao construir eixos, crie-os com
d3.axisBottom(scale)oud3.axisLeft(scale), configure os ticks e formate os rótulos comd3.format()e regenere ao redimensionar. - Ao criar tipos de gráfico, use geradores de formas (
d3.line(),d3.area(),d3.arc(),d3.pie(),d3.stack()) e funções de layout (d3.treemap(),d3.forceSimulation(),d3.geoPath()) para visualizações complexas. - Ao adicionar interatividade, use transições (
.transition().duration(750)) para atualizações suaves de dados, tooltips ao passar o mouse, e escovação/zoom para exploração. - Ao integrar com React, use D3 para matemática (escalas, layouts, transformações de dados) e React para renderização do DOM, computando valores em
useMemoe usandouseEffectcom refs para animações orientadas por D3.
Exemplos
Exemplo 1: Construir um dashboard em tempo real com múltiplos tipos de gráfico
Solicitação do usuário: "Crie um dashboard com gráficos de linha, gráficos de barras e um gráfico de pizza a partir de dados de API"
Ações:
- Configure escalas compartilhadas com
d3.scaleTime()para o eixo x ed3.scaleLinear()para o eixo y - Construa um gráfico de linhas usando
d3.line()com interpolação de curva suave e preenchimento de área - Construa um gráfico de barras agrupadas usando
d3.scaleBand()com transições de entrada escalonadas - Construa um gráfico de rosca usando
d3.pie()ed3.arc()com tooltips ao passar o mouse
Saída: Um dashboard responsivo com gráficos animados que se atualizam suavemente quando os dados mudam.
Exemplo 2: Criar um grafo de rede orientado por força
Solicitação do usuário: "Visualize relacionamentos entre entidades como um grafo de rede interativo"
Ações:
- Configure
d3.forceSimulation()comforceManyBody,forceLinkeforceCenter - Renderize nós como círculos com
d3.scaleOrdinal()colorindo por categoria - Adicione interação de arrastar com
d3.drag()para reposicionar nós - Implemente zoom e pan com
d3.zoom()e tooltips ao passar o mouse
Saída: Um grafo orientado por força interativo com nós arrastáveis, categorias codificadas por cores e navegação por zoom.
Diretrizes
- Use D3 para escalas, layouts e processamento de dados; deixe o React lidar com a renderização do DOM em aplicações React.
- Use
.join()em vez de enter/update/exit manual para vinculação de dados mais simples e limpa. - Defina sempre os domínios das escalas a partir dos dados (
d3.extent()) em vez de codificar intervalos. - Use
d3.format()para rótulos de eixos e tooltips:",.0f"para milhares,"$.2f"para moeda. - Adicione transições de 750ms com
easeCubicInOutpara animações suaves de atualização de dados. - Torne as visualizações responsivas recalculando escalas em callbacks do
ResizeObserver. - Adicione
aria-labelaos elementos SVG e tags<title>significativas para acessibilidade.