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
Paleta sin comandos
Sin comandos: probar ⌘ J.
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.
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-dialogdata-ts-command-opendata-ts-command-palettedata-ts-empty-fordata-ts-field-spinnerdata-ts-inputdata-ts-keywordsdata-ts-listboxdata-ts-listbox-emptydata-ts-listbox-inputdata-ts-listbox-paneldata-ts-shortcutdata-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.csstaisho.icon.csstaisho.input.csstaisho.kbd.csstaisho.loading-dots.csstaisho.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"conaria-autocomplete="list",aria-expandedyaria-controlsal listbox, yaria-activedescendantapunta 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,kjunto 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. |
| Enter | Ejecuta el comando resaltado. |
| Escape | Cierra 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.