Saltar al contenido
Alea0.1
Pro
  1. Alea
  2. Componentes
  3. Gráficos
  4. LineChart y AreaChart

GráficosAlea Pro

LineChart y AreaChart

Valores en el tiempo, suaves o rectos, con áreas, apilado, un tooltip y una vista de tabla de datos.

import { LineChart, AreaChart } from '@alea/pro';

Ejemplos

Líneas en el tiempo

Pasa el mouse, o Tab hasta el gráfico y usa las flechas, para leer cada mes. El botón de tabla muestra los mismos datos como tabla.

Visits and sign-ups

Both grew every month since August.

  • Visits
  • Sign-ups
02,5005,0007,50010,000MayJunJulAugSepOct

Área apilada

Partes de un todo en el tiempo: tráfico por fuente.

Traffic by source
  • Direct
  • Search
  • Social
05001,0001,500MonTueWedThuFriSatSun

Escalones, carga y foco en la leyenda

curve="step" para valores que cambian y se mantienen; isLoading muestra un relleno con brillo.

Plan and seats

Hover a legend item to focus its line.

  • Plan tier
  • Seats
02.557.510MonTueWedThuFri

Tokens

Los tokens de diseño que usa este componente, con su valor en el tema actual. Cambia cualquiera para darle otro estilo.

Color

  • --alea-border…
  • --alea-border-control…
  • --alea-focus…
  • --alea-text-muted…

Type

  • --alea-font-family-body…

Motion

  • --alea-motion-duration-base…
  • --alea-motion-duration-fast…
  • --alea-motion-duration-slower…
  • --alea-motion-ease-out…
  • --alea-motion-spring…

Props

LineChart props

Valores en el tiempo. Pasa el mouse o usa las flechas (después de Tab) para leer cada punto.

PropTipoPor defectoDescripción
dataobligatoriaChartRow[]-Filas de datos, una por valor de x o categoría.
seriesobligatoriaSeries[]-Las series a dibujar: key en cada fila, label para la leyenda, color opcional.
xobligatoriastring-La clave del eje x (fechas, meses, categorías).
areaboolean-Rellena bajo las líneas (un gráfico de área).
classNamestring-Clases extra para el elemento raíz.
curve"step" | "smooth" | "linear"'smooth'smooth (por defecto), líneas rectas, o escalones (valores que cambian en un momento y se mantienen).
descriptionReactNode-Una oración sobre lo que muestran los datos; se lee antes del gráfico.
heightnumber260Altura del gráfico en px. Por defecto 260.
isLoadingboolean-Muestra un relleno con brillo mientras cargan los datos.
showDotsboolean-Puntos en cada valor.
showTablebooleantrueMuestra el botón de tabla. Por defecto true.
stackedboolean-Apila las áreas una sobre otra.
titleReactNode-El título que se muestra arriba y que leen los lectores de pantalla.
valueFormat((v: number) => string)-Da formato a los valores (eje, tooltip, tabla).
xFormat((x: string | number) => string)-Da formato a las etiquetas de x.
zeroBasedbooleantrueEmpieza el eje y en cero. Por defecto true.

AreaChart props

Un LineChart relleno por debajo; stacked muestra partes de un todo en el tiempo.

PropTipoPor defectoDescripción
dataobligatoriaChartRow[]-Filas de datos, una por valor de x o categoría.
seriesobligatoriaSeries[]-Las series a dibujar: key en cada fila, label para la leyenda, color opcional.
xobligatoriastring-La clave del eje x (fechas, meses, categorías).
classNamestring-Clases extra para el elemento raíz.
curve"step" | "smooth" | "linear"-smooth (por defecto), líneas rectas, o escalones (valores que cambian en un momento y se mantienen).
descriptionReactNode-Una oración sobre lo que muestran los datos; se lee antes del gráfico.
heightnumber-Altura del gráfico en px. Por defecto 260.
isLoadingboolean-Muestra un relleno con brillo mientras cargan los datos.
showDotsboolean-Puntos en cada valor.
showTableboolean-Muestra el botón de tabla. Por defecto true.
stackedboolean-Apila las áreas una sobre otra.
titleReactNode-El título que se muestra arriba y que leen los lectores de pantalla.
valueFormat((v: number) => string)-Da formato a los valores (eje, tooltip, tabla).
xFormat((x: string | number) => string)-Da formato a las etiquetas de x.
zeroBasedboolean-Empieza el eje y en cero. Por defecto true.

Especificaciones

Generado desde el código: las variantes de los tipos, los estados y tokens del CSS, y los patrones de motion que aplican. Las grillas muestran el componente real en ambos temas; los números se miden en la página.

Variantes
curvestepsmoothlinear
Estados
Keyboard focus
Oscuro y claro
Cada color viene de tokens del tema, así que sigue a data-theme (y a presets como Graphite) en la página o en cualquier contenedor. El contraste se revisa en ambos temas.
Clases para estilos
.alea-chart-svgwrap.alea-chart-svg.alea-chart-grid.alea-chart-axis.alea-chart-area.alea-chart-line.alea-chart-dot.alea-chart-cross

Accesibilidad

  • Una figura con título y descripción; el gráfico es una imagen con un resumen como nombre (desde, hasta, el más alto).
  • Tab hasta el gráfico, y luego las flechas leen cada punto en voz alta.
  • Todo gráfico puede cambiar a una tabla de datos real.

Teclado

TeclaAcción
TabEnfoca el gráfico
Flecha izquierda / DerechaLee el punto anterior o siguiente
Inicio / FinPrimer o último punto
EscapeOculta el tooltip

Qué hacer y qué evitar

Hacer

  • Escribe la descripción como la conclusión: "Las visitas se duplicaron tras el lanzamiento".
  • Limítalo a cuatro series o menos.

Evitar

  • No dependas solo del color: nombra las series en la leyenda.

En Figma

Marcos de gráficos con las mismas variables de paleta (chart/1 a chart/8).

Probado con axe, teclado y roles de lector de pantalla