Saltar al contenido
Alea0.1
Pro
  1. Alea
  2. Componentes
  3. Datos
  4. Countdown y FormattedNumber

Datos

Countdown y FormattedNumber

El tiempo que falta hasta un momento, y números con el formato de quien lee: moneda, porcentaje, compacto.

import { Countdown, FormattedNumber } from '@alea/ui';

Ejemplos

Cuenta regresiva y números

La cuenta regresiva se actualiza cada segundo; los lectores de pantalla la escuchan una vez por minuto.

Launch in2 days, 4 hours, 58 minutes

Revenue

$126,560

1.8M visits · 4.3% conversion

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-text-muted…

Type

  • --alea-font-family-body…
  • --alea-font-size-sm…
  • --alea-font-weight-medium…

Props

Countdown props

El tiempo que falta hasta un momento, actualizado cada segundo. Los lectores de pantalla lo escuchan una vez por minuto, no cada segundo.

PropTipoPor defectoDescripción
labelobligatoriaReactNode-Hasta qué cuenta, leído antes del tiempo ("La oferta termina en").
toobligatorianumber | Date-Cuándo termina: un Date o una marca de tiempo en ms.
classNamestring-
onEnd(() => void)-Se llama una vez al llegar a cero.
showDaysboolean-Muestra días. Por defecto true cuando falta más de un día.

FormattedNumber props

Un número con el formato del idioma y región de quien lee: moneda, porcentaje, compacto.

PropTipoPor defectoDescripción
valueobligatorianumber-
formatNumberFormatOptions-Opciones de Intl.NumberFormat: { style: 'currency', currency: 'USD' }, { notation: 'compact' }, { style: 'percent' }.
localestring-Un locale BCP 47. Por defecto el del navegador.

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.

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-stat.alea-countdown.alea-stat-label.alea-stat-value.alea-countdown-value

Accesibilidad

  • La cuenta regresiva avanza visualmente cada segundo, pero los lectores de pantalla la escuchan una vez por minuto (una región live polite), no sesenta veces.

Qué hacer y qué evitar

Hacer

  • Di hasta qué cuenta en label.
  • Usa FormattedNumber en vez de formatear a mano: sigue el idioma y región de quien lee.

Evitar

  • No uses una cuenta regresiva para presionar a comprar.
Probado con axe, teclado y roles de lector de pantalla