'/%3e%3cg%20transform='translate(170%20205)%20scale(0.3606)'%20fill='%23111011'%3e%3cpath%20d='M497%20640H359L248%20320%20122%20640H0L256%200z'/%3e%3cpath%20d='M292.43%20640H200.8L248%20522z'/%3e%3cpath%20d='M335%200h138l111%20320L710%200h122L576%20640z'/%3e%3c/g%3e%3c/svg%3e){kind=small}
GráficosAlea Pro
BulletChart
Real contra meta sobre rangos malo, regular y bueno: muchos KPI en poco espacio.
import { BulletChart } from '@alea/pro';
Ejemplos
KPI contra metas
La barra es el valor real, la línea la meta, los tonos malo, regular y bueno.
Revenue ($k)270
New customers168
NPS47
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-focus…--alea-surface-raised…--alea-text…--alea-text-muted…
Space
--alea-space-3…
Type
--alea-font-size-md…--alea-font-weight-semibold…
Motion
--alea-motion-duration-slower…--alea-motion-spring…
Component
--alea-chart-1…
Props
BulletChart props
Real contra una meta, sobre rangos cualitativos (Stephen Few): muchos KPI en poco espacio.
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
dataobligatoria | { label: string; value: number; target?: number | undefined; ranges?: number[] | undefined; max?: number | undefined; }[] | - | Una fila por medida: el valor real, una meta, y rangos (malo, regular, bueno) como límites superiores. |
className | string | - | Clases extra para el elemento raíz. |
description | ReactNode | - | Una oración sobre lo que muestran los datos; se lee antes del gráfico. |
isLoading | boolean | - | Muestra un relleno con brillo mientras cargan los datos. |
showTable | boolean | true | Muestra el botón de tabla. Por defecto true. |
title | ReactNode | - | 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). |
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.
- Estados
- Keyboard focusPressed (CSS)
- 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-bullets.alea-bullet.alea-bullet-label.alea-bullet-track.alea-bullet-range.alea-bullet-value.alea-bullet-target.alea-bullet-num
Accesibilidad
- El gráfico es una figura con su título como nombre y su descripción; la imagen tiene un resumen en texto.
- Tab hasta el gráfico, luego las flechas recorren los datos y se anuncia cada valor; Escape sale.
- El botón de tabla muestra los mismos datos como tabla real para quien no puede usar la imagen.
Teclado
| Tecla | Acción |
|---|---|
| Tab | Enfoca el gráfico |
| Izquierda o Flecha derecha | Valor anterior o siguiente |
| Inicio o Fin | Primer o último valor |
| Escape | Borra la selección |
Qué hacer y qué evitar
Hacer
- Úsalo para muchos KPI en una lista o un panel.
- Nombra los rangos en la descripción para que los colores no sean la única pista.
Evitar
- No lo uses sin una meta: una barra de progreso es más simple.