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
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.
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-labelyts 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ú.
Relacionados
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-menudata-ts-menu-paneldata-ts-menu-triggerdata-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"yaria-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/Espacio | Activa el ítem enfocado. |
| Inicio/Fin | Va al primer / último ítem. |
| Tab | Cierra el menú y el foco sigue al próximo elemento de la página (no recorre los ítems). |
| Escape | Cierra 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.