CommandPalette
Paleta de comandos con overlay, filtrado en vivo y navegación por teclado, ideal para atajos tipo Cmd+K / Ctrl+K.
CommandPalette
Líneas de diseño
vue
1<script setup>2import { ref } from 'vue'34const openRubik = ref(false)5const paletteCommands = [6 { id: 'open', label: 'Open File', description: 'Open a file' },7 { id: 'save', label: 'Save File', description: 'Save changes' },8]9function onSelect(id) {10 console.log('selected', id)11}12</script>1314<Button @click="openRubik = true">Open palette (rubik)</Button>15<CommandPalette v-model="openRubik" :commands="paletteCommands" design="rubik" @select="onSelect" />Demo
Básico (commands + modelValue)
Una paleta funcional: se pasa commands y se vincula modelValue.
vue
1<script setup lang="ts">2import { ref } from 'vue'3import { CommandPalette } from '@dowardev/herdrate-vue'45const open = ref(false)6const commands = [7 { id: 'open', label: 'Open File', description: 'Abrir un archivo' },8 { id: 'save', label: 'Save File', description: 'Guardar cambios' },9 { id: 'close', label: 'Close', description: 'Cerrar pestaña' },10]1112function onSelect(id: string) {13 console.log('selected', id)14}15</script>1617<template>18 <button @click="open = true">Abrir paleta</button>19 <CommandPalette20 v-model="open"21 :commands="commands"22 placeholder="Escribe un comando..."23 @select="onSelect"24 />25</template>Color (color)
Cada botón abre una paleta funcional: compará el prompt (>) y el resaltado en ambos colores.
vue
1<script setup lang="ts">2import { ref } from 'vue'3import { Button, CommandPalette } from '@dowardev/herdrate-vue'45const openColorPrimary = ref(false)6const openColorSuccess = ref(false)7</script>89<template>10 <div style="display: flex; gap: 0.5rem;">11 <Button @click="openColorPrimary = true" color="primary">Abrir primary</Button>1213 <Button @click="openColorSuccess = true" color="success">Abrir success</Button>14 </div>1516 <CommandPalette v-model="openColorPrimary" :commands="commands" color="primary" @select="onSelect" />1718 <CommandPalette v-model="openColorSuccess" :commands="commands" color="success" @select="onSelect" />19</template>Props
commands
Lista de comandos disponibles para filtrar y seleccionar.
| Tipo | Por defecto | Requerido |
|---|---|---|
Array<{id, label, description?, icon?}> | [] | ❌ |
Cada comando tiene esta forma:
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | ✅ | Identificador único |
label | string | ✅ | Texto visible |
description | string | ❌ | Descripción opcional |
icon | string | ❌ | Icono o emoji |
modelValue
Controla apertura (true) y cierre (false) de la paleta.
| Tipo | Por defecto | Requerido |
|---|---|---|
boolean | false | ❌ |
color
Color del prompt (>) y del item resaltado.
| Tipo | Por defecto | Requerido |
|---|---|---|
'primary' | 'secondary' | 'tertiary' | 'success' | 'warning' | 'danger' | 'light' | 'medium' | 'dark' | 'primary' | ❌ |
placeholder
Placeholder del input de búsqueda.
| Tipo | Por defecto | Requerido |
|---|---|---|
string | 'Type a command...' | ❌ |
design
Línea de diseño (o hereda de data-design).
| Tipo | Por defecto | Requerido |
|---|---|---|
'tuix' | 'rubik' | — (hereda de data-design) | ❌ |
Eventos
| Evento | Payload | Descripción |
|---|---|---|
update:modelValue | boolean | Se emite al abrir/cerrar |
select | string | Se emite al seleccionar un comando (retorna id) |
CSS Custom Properties
| Token | Por defecto | Descripción |
|---|---|---|
--font-mono | "JetBrains Mono", ui-monospace, monospace | Stack monoespaciado para contenido tipo código (etiquetas, logs, chips). |
--accent | desde el tema (--ctp-latte-mauve / --ctp-mocha-mauve) | Color de acento, mapeado desde el color semántico activo. |
--bg | desde el tema (--ctp-latte-base / --ctp-mocha-base) | Fondo base de la superficie. |
--bg-alt | desde el tema (--ctp-latte-mantle / --ctp-mocha-mantle) | Fondo alternativo (la capa por debajo del fondo base). |
--bg-panel | desde el tema (--ctp-latte-surface1 / --ctp-mocha-surface1) | Fondo de superficies tipo panel (cards, accordions). |
--border | desde el tema (--ctp-latte-surface0 / --ctp-mocha-surface0) | Color de contorno y divisor de superficies. |
--text | desde el tema (--ctp-latte-text / --ctp-mocha-text) | Color de texto principal dentro del componente. |
--text-muted | desde el tema (--ctp-latte-subtext1 / --ctp-mocha-subtext1) | Texto secundario para pistas, anotaciones y estado deshabilitado. |
--color-primary | desde el tema (--ctp-latte-mauve / --ctp-mocha-mauve) | Color semántico primario (mauve en Catppuccin). |
--color-secondary | desde el tema (--ctp-latte-lavender / --ctp-mocha-lavender) | Color semántico secundario (lavender en Catppuccin). |
--color-tertiary | desde el tema (--ctp-latte-blue / --ctp-mocha-blue) | Color semántico terciario (blue en Catppuccin). |
--color-success | desde el tema (--ctp-latte-green / --ctp-mocha-green) | Color semántico de éxito (green en Catppuccin). |
--color-warning | desde el tema (--ctp-latte-yellow / --ctp-mocha-yellow) | Color semántico de advertencia (yellow en Catppuccin). |
--color-danger | desde el tema (--ctp-latte-red / --ctp-mocha-red) | Color semántico de peligro (red en Catppuccin). |
--color-light | desde el tema (--ctp-latte-surface1 / --ctp-mocha-rosewater) | Color semántico claro (tono de contraste más claro). |
--color-medium | desde el tema (--ctp-latte-overlay0 / --ctp-mocha-overlay2) | Color semántico medio (tono intermedio). |
--color-dark | desde el tema (--ctp-latte-text / --ctp-mocha-subtext1) | Color semántico oscuro (texto de alto contraste). |
--shadow | none on TUIX, elevated on rubik | Sombra de elevación para superficies elevadas. |
--shadow-hover | var(--shadow-hover, var(--shadow)) | Sombra en estado hover/active. |
Ver Theming para la convención completa.