Saltar al contenido

CommandPalette

Paleta de comandos estilo ⌘K: búsqueda difusa sobre acciones agrupadas, navegable por teclado. Se abre con ⌘/Ctrl + K o desde un botón.

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.

Paleta de comandos con atajo ⌘K

Nuevo archivo
Abrir proyecto
Preferencias
html

Paleta sin comandos

Sin comandos: probar ⌘ J.

html

Cuándo usarlo

  • La app tiene muchas acciones y destinos, y hace falta un acceso rápido y buscable a todos.
  • Tu público usa teclado y valora llegar a cualquier lado sin el mouse.
  • Se busca un único lugar para navegar y ejecutar en vez de cazar botones.

Cuándo no

  • Son pocas acciones sobre un disparador puntual → menu.
  • El caso es capturar un valor de formulario, no ejecutar comandos → combobox.
  • Las acciones son sobre un elemento con clic derecho → context-menu.

Cómo usarlo

  • Los comandos se agrupan y se escriben buenos textos: es lo que se filtra.
  • Conviene ofrecer también una vía visible (un botón ⌘K) para que se descubra.

Cómo no usarlo

  • No se convierte en el único camino: no todos saben que existe ⌘K.
  • No se ponen comandos destructivos sin confirmación detrás de un match rápido.

Relacionados

MenuComboboxSelect

TaishoDS Core

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

Combina un atajo de teclado global, filtrado y foco.

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

  • data-ts-command-dialog
  • data-ts-command-open
  • data-ts-command-palette
  • data-ts-empty-for
  • data-ts-field-spinner
  • data-ts-input
  • data-ts-keywords
  • data-ts-listbox
  • data-ts-listbox-empty
  • data-ts-listbox-input
  • data-ts-listbox-panel
  • data-ts-shortcut
  • data-ts-value

Qué hace: Atajo de teclado global, filtrado y navegación de la lista. Inicio y Fin son del cursor de la entrada. Va sobre un <dialog> modal: Escape lo cierra con una sola pulsación. Los textos de «sin resultados» salen de una plantilla en data-ts-empty-for («Sin resultados para "…"»).

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

  • taisho.button.css
  • taisho.icon.css
  • taisho.input.css
  • taisho.kbd.css
  • taisho.loading-dots.css
  • taisho.spinner.css

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

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

  • Foco automático en el buscador al abrir; ↑/↓ mueven la selección, Enter ejecuta, Escape cierra con una sola pulsación (en el Core lo hace el <dialog> nativo).
  • La entrada es un role="combobox" con aria-autocomplete="list", aria-expanded y aria-controls al listbox, y aria-activedescendant apunta a la opción resaltada: el lector la anuncia sin sacar el foco de la entrada.
  • Las opciones no son tabulables: el foco es virtual. Presionarlas con el mouse no le saca el foco a la entrada. Inicio y Fin mueven el cursor del texto, no la opción resaltada. Al cerrar (Escape, elegir o clic afuera) el foco vuelve a lo que lo tenía al abrir.
  • El atajo global se configura con data-ts-shortcut (por defecto, k junto a Ctrl o ⌘).

Teclado

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

Tecla Qué hace
↑↓Recorre los resultados.
EnterEjecuta el comando resaltado.
EscapeCierra la paleta.

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.