Sunburst Chart — klin

Vista previa#

Jerarquía en anillos. Demo completa con datos realistas, renderizada en el servidor. Más abajo están las configuraciones, una por una.

Servicios públicos · $790Obra pública · $650Seguridad · $430

Ejemplos#

Todas las configuraciones del componente, cada una viva y con datos propios. Cambia entre Preview y Code en cada tarjeta y copia lo que necesites.

Primaria · 325Secundaria · 150

dos niveles con formato por defecto

Nómina · $5,200,000Obra · $1,400,000

tres niveles con formato moneda

Solar · 480 GWhEólica · 45 GWh

jerarquía dominada por una rama con colores

Uso#

Ejemplo mínimo con las props requeridas. Copia, pega y cambia los datos:

import { ChartTooltipPortal, SunburstChart } from "@carlos-burelo/klin";
import "@carlos-burelo/klin/styles.css";
 
<ChartTooltipPortal>
<SunburstChart
  data={/* … */}
  ariaLabel="Sunburst Chart"
/>
</ChartTooltipPortal>

SSR-first

La gráfica es función pura de props a SVG: el HTML llega renderizado y sin JS se ve completa. Envuelve en ChartTooltipPortal solo si quieres tooltip rico; sin JS queda \<title\> nativo. Lee la guía /docs/ssr-first una vez y listo.

Código de esta demo#

Ver fuente (src/demos/sunburst-chart.tsx)

import type { SunburstNode } from "@carlos-burelo/klin";
import { ChartTooltipPortal, SunburstChart } from "@carlos-burelo/klin";
 
const data: SunburstNode[] = [
  {
    label: "Servicios públicos",
    children: [
      { label: "Agua potable", value: 320 },
      { label: "Alumbrado", value: 180 },
      { label: "Limpia", value: 150 },
    ],
  },
  {
    label: "Obra pública",
    children: [
      { label: "Pavimentación", value: 410 },
      { label: "Parques", value: 120 },
      { label: "Drenaje", value: 260 },
    ],
  },
  {
    label: "Seguridad",
    children: [
      { label: "Patrullaje", value: 290 },
      { label: "Videovigilancia", value: 140 },
    ],
  },
];
 
function format(value: number): string {
  return new Intl.NumberFormat("es-MX", {
    style: "currency",
    currency: "MXN",
    maximumFractionDigits: 0,
  }).format(value);
}
 
export default function SunburstChartDemo() {
  return (
    <ChartTooltipPortal>
      <SunburstChart
        data={data}
        ariaLabel="Distribución del presupuesto municipal por rubro y programa"
        format={format}
      />
    </ChartTooltipPortal>
  );
}

Props#

14 props · 2 requeridas

Prop	Tipo	Descripción
data req	SunburstNode[]	Filas de datos (records). Valores no-finitos se tratan como 0, nunca NaN en SVG.
ariaLabel req	string	Etiqueta descriptiva del SVG (role=img). Describe la conclusión, no solo el tipo.
size opc	number	Sin descripción aún — pide docs.
format opc	(value: number) => string	Sin descripción aún — pide docs.
locale opc	string	Locale de formato (por defecto es-MX).
depth opc	number	Profundidad máxima de anillos (se podan los más profundos); si se omite no poda.
showRootLabel opc	boolean	Muestra la etiqueta central con el total.
cornerRadius opc	number	Radio de esquina de los arcos.
padAngle opc	number	Separación angular entre arcos (radianes).
emptyTitle opc	string	Título del estado vacío (por defecto EMPTY_TITLE).
emptyDescription opc	string	Descripción del estado vacío.
className opc	string	Clase extra en el contenedor (aditivo, no rompe estilos).
style opc	CSSProperties	Estilos inline extra en el contenedor.
ariaDescribedBy opc	string	Id de un texto largo que describe la gráfica (opcionales detalles).

Tipo completo: SunburstChartProps en sunburst-chart.tsx.

Accesibilidad#

Toda gráfica exige ariaLabel descriptivo; el SVG usa role="img" con \<title\>.
Cada forma lleva \<title\> nativo (tooltip sin JS) y data-chart-tip para el portal rico.
Sin datos se renderiza estado vacío homogéneo (ChartEmpty), nunca SVG roto.
Detalle del contrato en /docs/accesibilidad.

Recursos#

Fuente del componente: sunburst-chart.tsx
Guías: SSR-first · Tema · Tooltip