Saltar al contenido
Alea0.1
Pro
  1. Alea
  2. Componentes
  3. Navegación
  4. BottomNavigation

Navegación

BottomNavigation

La barra de pestañas de una app móvil: de tres a cinco destinos con íconos, etiquetas y badges.

import { BottomNavigation } from '@alea/ui';

Ejemplos

Barra de pestañas móvil

Se muestra en línea aquí; por defecto se queda fija abajo de la pantalla.

home

Configuraciones

Cada valor de cada propiedad, lado a lado. Los números coinciden con la leyenda.

fixed: false
fixed: true
  1. Fixedfixed

Estados

Cada estado de interacción, forzado para compararlos, en ambos temas.

Oscuro

Habilitado
Hover
Foco
Presionado

Claro

Habilitado
Hover
Foco
Presionado

Anatomía

Las partes del componente y la clase que da estilo a cada una.

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-accent-strong…
  • --alea-accent-subtle…
  • --alea-border…
  • --alea-status-danger-on-solid…
  • --alea-status-danger-solid…
  • --alea-surface…
  • --alea-text-muted…

Radius

  • --alea-radius-full…

Type

  • --alea-font-family-body…
  • --alea-font-size-2xs…
  • --alea-font-weight-medium…

Motion

  • --alea-motion-duration-base…

Layer

  • --alea-z-sticky…

Component

  • --alea-glass-blur…
  • --alea-glass-saturate…
  • --alea-glass-tint…

Props

BottomNavigation props

La barra de pestañas de una app móvil: de tres a cinco destinos con íconos y etiquetas.

PropTipoPor defectoDescripción
itemsobligatoria{ id: string; label: string; icon: ReactNode; href?: string | undefined; badge?: number | undefined; }[]-De tres a cinco destinos: id, label, icon, y un href (enlaces) o nada (botones con onChange).
valueobligatoriastring-El destino actual.
aria-labelstring-Nombre de la navegación. Por defecto "Principal".
classNamestring-Clases extra para el elemento raíz.
fixedbooleantrueSe queda fija abajo de la pantalla. Por defecto true.
onChange((id: string) => void)-Se llama con el id del destino elegido.

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.

Motion
press
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-bottomnav.alea-bottomnav-icon.alea-bottomnav-badge.alea-bottomnav-label.alea-bottomnav-item
Atributos data
data-fixed

Accesibilidad

  • Un landmark de navegación con enlaces o botones; el actual tiene aria-current y los badges se leen como "3 nuevos".

Teclado

TeclaAcción
TabSe mueve entre destinos
EnterVa al destino

Qué hacer y qué evitar

Hacer

  • Mantén las etiquetas visibles: los íconos solos son adivinanzas.

Evitar

  • No uses más de cinco elementos.
Probado con axe, teclado y roles de lector de pantalla