Documentação

Visão Geral

KatuCharts é uma biblioteca de gráficos leve em dependências. 64 tipos de gráficos, uma única API declarativa e módulos opcionais para finanças, bioinformática e tabelas de dados — v0.2.31.

Instalar

Instale o pacote principal do npm. Cada módulo complementar é uma importação separada, então você carrega apenas os módulos que usa.

npm install katucharts.js

# optional modules register themselves when imported
import KatuCharts from 'katucharts.js';
import 'katucharts.js/finance';
import 'katucharts.js/bio';
import { DataTable } from 'katucharts.js/datatable';
import { KatuChartsReact } from 'katucharts.js/react';

Ou coloque o build UMD de um CDN — sem bundler necessário:

<script src="https://unpkg.com/katucharts.js/dist/katucharts.umd.js"></script>
<div id="chart" style="width:100%;height:420px"></div>
<script>
  var KatuCharts = window.KatuCharts.default || window.KatuCharts.KatuCharts || window.KatuCharts;
  KatuCharts.chart('chart', {
    series: [{ type: 'line', data: [1, 3, 2, 5, 4] }]
  });
</script>

Início rápido

Todo gráfico é criado com KatuCharts.chart(container, options). O container pode ser um id de elemento ou um nó DOM.

import KatuCharts from 'katucharts.js';

KatuCharts.chart('my-chart', {
  chart: { type: 'areaspline' },
  title: { text: 'Weekly Traffic' },
  xAxis: { categories: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri'] },
  series: [
    { name: 'Desktop', data: [450, 520, 480, 610, 580] },
    { name: 'Mobile',  data: [280, 350, 420, 510, 490] }
  ]
});

Procurando um tipo de gráfico? A galeria interativa renderiza todos os 64 tipos, e Tipos de Gráficos documenta o formato de dados para cada um.

Módulos

O bundle principal cobre gráficos cartesianos, estatísticos, hierárquicos e de fluxo. Gráficos especializados vêm como módulos de opt-in que registram seus tipos ao serem importados, por exemplo import 'katucharts.js/bio'.

Importar	Adiciona
`katucharts.js`	Core — linha, área, colunas, barras, dispersão, bolhas, pizza/rosca, medidor, polar, treemap, sunburst, funil, mapa de calor, cascata, boxplot, sankey, rede, roda de dependências
`katucharts.js/finance`	Heikin-Ashi, hollow candlestick, volume, baseline, Renko, Kagi e outros + 19 indicadores técnicos
`katucharts.js/bio`	Vulcão, Manhattan, Kaplan-Meier, forest plot, sequence logo, heatmap agrupado, circos, PCoA, árvore filogenética
`katucharts.js/datatable`	Grade de dados interativa ordenável, filtrável e paginada
`katucharts.js/react`	Componente wrapper React

Por Que KatuCharts

Uma API, 64 tipos — mude o tipo de gráfico alterando uma única string type.
Modular — finance, bio e data-table são importações opcionais que você adiciona sobre o core.
Construído para ciência e finanças — gráficos de bioinformática prontos para publicação e séries temporais financeiras prontas para uso.
Tempo real — streaming de WebSocket, SSE ou polling com adaptadores integrados.
Acessível — funções ARIA, navegação por teclado e descrições para leitores de tela.
Exportações — PNG, JPEG, SVG, PDF, CSV, XLS em uma única chamada (PDF requer o pacote opcional jspdf).