Documentación

Descripción general

KatuCharts es una librería de gráficos ligera en dependencias. 64 tipos de gráficos, una única API declarativa y módulos opcionales para finanzas, bioinformática y tablas de datos — v0.2.31.

Instalación

Instala el paquete principal desde npm. Cada módulo adicional es una importación separada, así que solo cargas los módulos que uses.

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';

O usa la compilación UMD desde un CDN — sin bundler requerido:

<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>

Inicio rápido

Cada gráfico se crea con KatuCharts.chart(container, options). El contenedor puede ser un id de elemento o un nodo 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] }
  ]
});
¿Buscas un tipo de gráfico? La galería en vivo renderiza los 64 tipos, y Tipos de gráficos documenta la estructura de datos para cada uno.

Módulos

El bundle principal cubre gráficos cartesianos, estadísticos, jerárquicos y de flujo. Los gráficos especializados se distribuyen como módulos opcionales que registran sus tipos al importarlos, por ejemplo import 'katucharts.js/bio'.

ImportaciónIncluye
katucharts.jsPrincipal — línea, área, columnas, barras, dispersión, burbujas, circular/anillo, indicador, polar, treemap, sunburst, embudo, mapa de calor, cascada, boxplot, sankey, red, rueda de dependencias
katucharts.js/financeHeikin-Ashi, velas huecas, volumen, línea base, Renko, Kagi y más + 19 indicadores técnicos
katucharts.js/bioVolcán, Manhattan, Kaplan-Meier, forest plot, logo de secuencia, mapa de calor agrupado, circos, PCoA, árbol filogenético
katucharts.js/datatableCuadrícula de datos interactiva con clasificación, filtrado y paginación
katucharts.js/reactComponente envolvente de React

Por qué KatuCharts

  • Una API, 64 tipos — cambia el tipo de gráfico modificando una única cadena type.
  • Modular — finance, bio y data-table son importaciones opcionales que añades sobre el core.
  • Construido para ciencia y finanzas — gráficos bioinformáticos listos para publicación y series de tiempo financieras listas para usar.
  • Tiempo real — transmite desde WebSocket, SSE o encuesta con adaptadores integrados.
  • Accesible — roles ARIA, navegación por teclado y descripciones para lectores de pantalla.
  • Exportación — PNG, JPEG, SVG, PDF, CSV, XLS en una sola llamada (PDF requiere el paquete opcional jspdf).