Saltar al contenido

Menu

Menú desplegable de acciones anclado a un disparador (patrón APG menu). El disparador lleva data-ts-menu-trigger; el panel, data-ts-menu-panel, con ts menu-item, ts menu-separator y ts menu-label adentro. Es para ejecutar, no para elegir un valor.

Capas flotantes · TaishoDS Core, en HTML plano.

Ejemplos

Un ejemplo por caso, funcionando. Cada ejemplo es el HTML de su vista previa: se copia tal cual y, con el CSS y el JS del Core cargados, se ve y funciona igual.

Menú de acciones

html

Referencia de clases

Todos los valores de cada modificador, con su HTML listo para copiar.

Posición

Dónde se ancla el panel respecto del disparador al abrirse. Cada uno se ve con un clic.

html

Cuándo usarlo

  • Agrupar acciones secundarias detrás de un botón (“⋯”, “Opciones”).
  • Las acciones no entran cómodas en la barra pero se usan seguido.
  • Cada ítem ejecuta algo (navegar, editar, borrar); no deja un valor seleccionado.

Cuándo no

  • El caso es elegir un valor de formulario que queda elegido → select.
  • El menú se dispara con clic derecho sobre un contenido → context-menu.
  • Son comandos de toda la app, buscables con ⌘K → command-palette.

Cómo usarlo

  • Se agrupa con ts menu-label y ts menu-separator, y lo destructivo queda aparte y al final.
  • El disparador tiene que tener nombre accesible (texto o aria-label).

Cómo no usarlo

  • No se mete un formulario adentro: es una lista de acciones, no un panel → popover.
  • La acción primaria de la pantalla no se esconde dentro de un menú.

TaishoDS Core

Necesita el JS del Core: maneja foco, teclado y estado.

La Popover API muestra el menú, pero no navega: el teclado y los submenús son del Core.

El Core lo engancha por estos atributos. Van en el marcado; no hace falta inicializar nada.

  • data-ts-menu
  • data-ts-menu-panel
  • data-ts-menu-trigger
  • data-ts-value

Qué hace: Patrón menu de la APG: foco por código en los ítems (tabindex="-1"), ↑ ↓, Inicio y Fin, Tab que cierra, apertura de submenús y cierre en cascada.

Sin build, desde el CDN: taisho.menu.css, además de taisho.base.css. También se carga:

  • taisho.separator.css

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

Implementa el patrón Menu Button de la WAI-ARIA APG.

  • El trigger expone aria-haspopup="menu" y aria-expanded.
  • Los ítems llevan tabindex="-1": reciben el foco por código, no por Tab. ← → no mueven el foco en un menú vertical.
  • Se abre con Enter, Espacio o ↓ desde el trigger; dentro, ↑ y ↓ navegan (con vuelta), Enter selecciona y Escape cierra devolviendo el foco al trigger.

Teclado

Además de lo que ya hace el navegador (Tab mueve el foco, Enter activa un botón).

Tecla Qué hace
↑↓Recorre los ítems.
Enter/EspacioActiva el ítem enfocado.
Inicio/FinVa al primer / último ítem.
TabCierra el menú y el foco sigue al próximo elemento de la página (no recorre los ítems).
EscapeCierra y devuelve el foco al trigger.

Verificación

Qué se probó de verdad. Lo que no se probó lo dice: preferimos un «sin verificar» a una afirmación de más.

  • axe WCAG 2.2 A + AA en navegador real, en tema claro y oscuro, antes de cada versión.
  • teclado Mapa de teclas documentado arriba, contrastado contra el componente.
  • lector de pantalla Sin verificar con lector de pantalla. Conviene probarlo en la combinación de componentes propia, no sólo aquí, donde cada uno aparece solo y en su estado feliz.