Skip to content

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.

TipoPor defectoRequerido
Array<{id, label, description?, icon?}>[]❌

Cada comando tiene esta forma:

CampoTipoRequeridoDescripción
idstring✅Identificador único
labelstring✅Texto visible
descriptionstring❌Descripción opcional
iconstring❌Icono o emoji

modelValue ​

Controla apertura (true) y cierre (false) de la paleta.

TipoPor defectoRequerido
booleanfalse❌

color ​

Color del prompt (>) y del item resaltado.

TipoPor defectoRequerido
'primary' | 'secondary' | 'tertiary' | 'success' | 'warning' | 'danger' | 'light' | 'medium' | 'dark''primary'❌

placeholder ​

Placeholder del input de búsqueda.

TipoPor defectoRequerido
string'Type a command...'❌

design ​

Línea de diseño (o hereda de data-design).

TipoPor defectoRequerido
'tuix' | 'rubik'— (hereda de data-design)❌

Eventos ​

EventoPayloadDescripción
update:modelValuebooleanSe emite al abrir/cerrar
selectstringSe emite al seleccionar un comando (retorna id)

CSS Custom Properties ​

TokenPor defectoDescripción
--font-mono"JetBrains Mono", ui-monospace, monospaceStack monoespaciado para contenido tipo código (etiquetas, logs, chips).
--accentdesde el tema (--ctp-latte-mauve / --ctp-mocha-mauve)Color de acento, mapeado desde el color semántico activo.
--bgdesde el tema (--ctp-latte-base / --ctp-mocha-base)Fondo base de la superficie.
--bg-altdesde el tema (--ctp-latte-mantle / --ctp-mocha-mantle)Fondo alternativo (la capa por debajo del fondo base).
--bg-paneldesde el tema (--ctp-latte-surface1 / --ctp-mocha-surface1)Fondo de superficies tipo panel (cards, accordions).
--borderdesde el tema (--ctp-latte-surface0 / --ctp-mocha-surface0)Color de contorno y divisor de superficies.
--textdesde el tema (--ctp-latte-text / --ctp-mocha-text)Color de texto principal dentro del componente.
--text-muteddesde el tema (--ctp-latte-subtext1 / --ctp-mocha-subtext1)Texto secundario para pistas, anotaciones y estado deshabilitado.
--color-primarydesde el tema (--ctp-latte-mauve / --ctp-mocha-mauve)Color semántico primario (mauve en Catppuccin).
--color-secondarydesde el tema (--ctp-latte-lavender / --ctp-mocha-lavender)Color semántico secundario (lavender en Catppuccin).
--color-tertiarydesde el tema (--ctp-latte-blue / --ctp-mocha-blue)Color semántico terciario (blue en Catppuccin).
--color-successdesde el tema (--ctp-latte-green / --ctp-mocha-green)Color semántico de éxito (green en Catppuccin).
--color-warningdesde el tema (--ctp-latte-yellow / --ctp-mocha-yellow)Color semántico de advertencia (yellow en Catppuccin).
--color-dangerdesde el tema (--ctp-latte-red / --ctp-mocha-red)Color semántico de peligro (red en Catppuccin).
--color-lightdesde el tema (--ctp-latte-surface1 / --ctp-mocha-rosewater)Color semántico claro (tono de contraste más claro).
--color-mediumdesde el tema (--ctp-latte-overlay0 / --ctp-mocha-overlay2)Color semántico medio (tono intermedio).
--color-darkdesde el tema (--ctp-latte-text / --ctp-mocha-subtext1)Color semántico oscuro (texto de alto contraste).
--shadownone on TUIX, elevated on rubikSombra de elevación para superficies elevadas.
--shadow-hovervar(--shadow-hover, var(--shadow))Sombra en estado hover/active.

Ver Theming para la convención completa.