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

Navegación

Menubar

Una barra de menús de app de escritorio (Archivo, Editar, Ver) con el modelo de teclado completo de WAI-ARIA.

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

Ejemplos

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-surface…
  • --alea-surface-hover…
  • --alea-text…

Radius

  • --alea-radius-md…

Type

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

Props

Menubar props

Una barra de menús de app de escritorio (Archivo, Editar, Ver): las flechas se mueven entre menús, Enter o Abajo abre uno (menubar de WAI-ARIA).

PropTipoPor defectoDescripción
aria-labelobligatoriastring-Nombre de la barra de menús ("Editor").
menusobligatoria{ id: string; label: string; items: MenuEntry[]; }[]-Los menús, de izquierda a derecha: una etiqueta y sus items.
classNamestring-Clases extra para el elemento raíz.
motionMotionProp-Cómo entra y sale el popup: un preset (fade, scale, pop, slide-down, blur...), false para ninguno, u opciones.
onAction((menu: string, item: Key) => void)-Se llama con el id del menú y el id del elemento.

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
Hover (CSS)
Motion
presstintAcepta una prop motion para su entrada y salida.
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-menubar.alea-menubar-slot.alea-menubar-item.alea-menu-popover.alea-menu

Accesibilidad

  • role menubar con foco itinerante: una sola parada de Tab.
  • Con un menú abierto, Izquierda y Derecha pasan al siguiente menú.

Teclado

TeclaAcción
Flecha izquierda / DerechaMoverse entre menús
Enter, Espacio o AbajoAbrir
EscapeCerrar

Qué hacer y qué evitar

Hacer

  • Úsala en apps de estilo escritorio con muchos comandos.
  • Limita los menús principales a seis o menos.

Evitar

  • No la uses para navegar un sitio web: usa NavigationMenu.
  • No pongas acciones frecuentes solo en menús: agrega una barra de herramientas.
Probado con axe, teclado y roles de lector de pantalla