Saltar al contenido

ContextMenu

Menú de acciones que aparece con clic derecho sobre un elemento. El elemento objetivo lleva data-ts-context-menu y los ítems son los mismos del Menu.

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ú contextual sobre un proyecto

Clic derecho sobre «API de pagos».
html

Cuándo usarlo

  • Ofrecer acciones contextuales sobre un ítem (una fila, un archivo, una tarjeta).
  • Como atajo para usuarios expertos, además de una vía visible.
  • Las acciones dependen del elemento sobre el que se hace clic derecho.

Cuándo no

  • Sería la única forma de llegar a la acción: el clic derecho no se descubre solo → se suma un menu visible.
  • Las acciones son globales, no sobre un elemento puntual → menu o command-palette.
  • El público es táctil: en mobile no hay clic derecho, así que hace falta otra vía.

Cómo usarlo

  • Lo importante se duplica en una vía visible: el menú contextual complementa, no reemplaza.
  • La lista se mantiene corta y relevante al objetivo del clic.

Cómo no usarlo

  • No se pone ahí la única manera de hacer algo crítico.
  • No se replica el menú entero de la app: sólo lo que aplica al elemento.

Relacionados

MenuCommandPalette

TaishoDS Core

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

Funciona como Menu, disparado por clic derecho.

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

  • data-ts-context-menu
  • data-ts-menu
  • data-ts-menu-panel
  • data-ts-value

Qué hace: Todo lo de Menu, más posicionar en las coordenadas del puntero, suprimir el menú del navegador y abrir con Shift+F10 o la tecla ContextMenu (en la esquina inferior izquierda del área, con el foco en el primer ítem).

Sin build, desde el CDN: taisho.context-menu.css, además de taisho.base.css. Con ese archivo alcanza.

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

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

  • Con el clic derecho se abre en la posición del cursor, ajustándose para no salirse del viewport.
  • Navegación por teclado dentro del menú y cierre con Escape o clic afuera.
  • Los ítems son los mismos del Menu: botones con role="menuitem", con ícono opcional y los estados variant-danger e is-disabled.

Teclado

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

Tecla Qué hace
Shift+F10/tecla«ContextMenu»Con el foco dentro del área, abre el menú en su esquina inferior izquierda y enfoca el primer ítem.
↑↓InicioFinRecorren los ítems (con wrap).
TabCierra el menú y el foco sigue al próximo elemento de la página.
EscapeCierra el menú y devuelve el foco a quien lo tenía al abrir.

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.