Donut Chart — klin

Vista previa#

Partes con total al centro y % del total. Demo completa con datos realistas, renderizada en el servidor. Más abajo están las configuraciones, una por una.

Jalisco · 320Nuevo León · 280Puebla · 190Oaxaca · 140Yucatán · 110

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.

Jalisco · 320Nuevo León · 280Puebla · 190Oaxaca · 140Yucatán · 110

Matrícula por estado con total al centro y leyenda

Presupuesto por área sin leyenda y con formato de moneda

Marca líder · 58 %Competidor A · 22 %Competidor B · 13 %Otras · 7 %

Participación dominada por una categoría, sin total al centro

Uso#

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

import { ChartTooltipPortal, DonutChart } from "@carlos-burelo/klin";
import "@carlos-burelo/klin/styles.css";
 
<ChartTooltipPortal>
<DonutChart
  data={/* … */}
  ariaLabel="Donut 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/donut-chart.tsx)

/**
 * Demo Dona del site (no se publica en el bundle de la lib).
 */
import { ChartTooltipPortal, DonutChart } from "@carlos-burelo/klin";
 
export default function DonutChartDemo() {
  return (
    <ChartTooltipPortal>
      <DonutChart
        ariaLabel="Gráfico de dona de matrícula por estado"
        totalLabel="Alumnos"
        data={[
          { label: "Jalisco", value: 320 },
          { label: "Nuevo León", value: 280 },
          { label: "Puebla", value: 190 },
          { label: "Oaxaca", value: 140 },
          { label: "Yucatán", value: 110 },
        ]}
      />
    </ChartTooltipPortal>
  );
}

Props#

20 props · 2 requeridas

Prop	Tipo	Descripción
data req	DonutDatum[]	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.
thickness opc	number	Sin descripción aún — pide docs.
format opc	ValueFormatter	Sin descripción aún — pide docs.
locale opc	string	Locale de formato (por defecto es-MX).
itemColor opc	(datum: DonutDatum, index: number) => string \| undefined	Color por rebanada. Si retorna `undefined` se usa el color de serie. Se respeta `datum.color` primero. /
totalLabel opc	string	Sin descripción aún — pide docs.
showTotal opc	boolean	Sin descripción aún — pide docs.
startAngle opc	number	Ángulo inicial de la primera rebanada en radianes (0 = arriba). @default 0 /
padAngle opc	number	Separación entre rebanadas en radianes. @default 0 /
sortSlices opc	boolean	Ordena las rebanadas de mayor a menor (por defecto respeta la entrada). @default false /
cornerRadius opc	number	Radio de esquina de los arcos (0 = bordes rectos). @default 0 /
innerLabels opc	'none' \| 'percent'	Etiqueta dentro de la rebanada: el % solo si el arco es grande. @default 'none' /
showLegend opc	boolean	Muestra la leyenda HTML SSR (por defecto true donde aplica).
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).
emptyTitle opc	string	Título del estado vacío (por defecto EMPTY_TITLE).
emptyDescription opc	string	Descripción del estado vacío.

Tipo completo: DonutChartProps en donut-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: donut-chart.tsx
Guías: SSR-first · Tema · Tooltip

Vista previa#

Partes con total al centro y % del total. Demo completa con datos realistas, renderizada en el servidor. Más abajo están las configuraciones, una por una.

Jalisco · 320Nuevo León · 280Puebla · 190Oaxaca · 140Yucatán · 110

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.

Jalisco · 320Nuevo León · 280Puebla · 190Oaxaca · 140Yucatán · 110

Matrícula por estado con total al centro y leyenda

Presupuesto por área sin leyenda y con formato de moneda

Marca líder · 58 %Competidor A · 22 %Competidor B · 13 %Otras · 7 %

Participación dominada por una categoría, sin total al centro

Uso#

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

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

SSR-first

Código de esta demo#

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

/**
 * Demo Dona del site (no se publica en el bundle de la lib).
 */
import { ChartTooltipPortal, DonutChart } from "@carlos-burelo/klin";
 
export default function DonutChartDemo() {
  return (
    <ChartTooltipPortal>
      <DonutChart
        ariaLabel="Gráfico de dona de matrícula por estado"
        totalLabel="Alumnos"
        data={[
          { label: "Jalisco", value: 320 },
          { label: "Nuevo León", value: 280 },
          { label: "Puebla", value: 190 },
          { label: "Oaxaca", value: 140 },
          { label: "Yucatán", value: 110 },
        ]}
      />
    </ChartTooltipPortal>
  );
}

Props#

20 props · 2 requeridas

Prop	Tipo	Descripción
data req	DonutDatum[]	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.
thickness opc	number	Sin descripción aún — pide docs.
format opc	ValueFormatter	Sin descripción aún — pide docs.
locale opc	string	Locale de formato (por defecto es-MX).
itemColor opc	(datum: DonutDatum, index: number) => string \| undefined	Color por rebanada. Si retorna `undefined` se usa el color de serie. Se respeta `datum.color` primero. /
totalLabel opc	string	Sin descripción aún — pide docs.
showTotal opc	boolean	Sin descripción aún — pide docs.
startAngle opc	number	Ángulo inicial de la primera rebanada en radianes (0 = arriba). @default 0 /
padAngle opc	number	Separación entre rebanadas en radianes. @default 0 /
sortSlices opc	boolean	Ordena las rebanadas de mayor a menor (por defecto respeta la entrada). @default false /
cornerRadius opc	number	Radio de esquina de los arcos (0 = bordes rectos). @default 0 /
innerLabels opc	'none' \| 'percent'	Etiqueta dentro de la rebanada: el % solo si el arco es grande. @default 'none' /
showLegend opc	boolean	Muestra la leyenda HTML SSR (por defecto true donde aplica).
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).
emptyTitle opc	string	Título del estado vacío (por defecto EMPTY_TITLE).
emptyDescription opc	string	Descripción del estado vacío.

Tipo completo: DonutChartProps en donut-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: donut-chart.tsx
Guías: SSR-first · Tema · Tooltip