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ón | Incluye |
|---|---|
katucharts.js | Principal — 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/finance | Heikin-Ashi, velas huecas, volumen, línea base, Renko, Kagi y más + 19 indicadores técnicos |
katucharts.js/bio | Volcán, Manhattan, Kaplan-Meier, forest plot, logo de secuencia, mapa de calor agrupado, circos, PCoA, árbol filogenético |
katucharts.js/datatable | Cuadrícula de datos interactiva con clasificación, filtrado y paginación |
katucharts.js/react | Componente 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).