Skip to content

ComboBox

Input con dropdown de opciones filtrables. Soporta navegación por teclado (↑↓, Enter, Escape).

ComboBox

Demo

vue
<ComboBox v-model="fruta" :items="frutas" placeholder="Escribe para buscar..." />

Props

modelValue

Valor seleccionado (v-model).

vue
<ComboBox v-model="fruta" :items="frutas" />

items

Array de opciones filtrables.

ts
const items = [
  { label: 'Apple', value: 'apple' },
  { label: 'Banana', value: 'banana' },
]
vue
<ComboBox v-model="fruta" :items="frutas" />

color

Color de foco y highlight del dropdown.

vue
<ComboBox v-model="fruta" :items="frutas" color="primary" placeholder="Primary" />
<ComboBox v-model="fruta" :items="frutas" color="success" placeholder="Success" />
<ComboBox v-model="fruta" :items="frutas" color="danger" placeholder="Danger" />

placeholder

Texto dentro del input mientras está vacío.

vue
<ComboBox v-model="fruta" :items="frutas" placeholder="Buscar fruta..." />

disabled

Deshabilita la interacción.

vue
<ComboBox v-model="fruta" :items="frutas" disabled />

Events

EventoPayloadDescripción
update:modelValuestringSe emite al seleccionar un ítem

Tipos

ComboOption

CampoTipoRequeridoDescripción
labelstringTexto visible
valuestringValor interno

API

PropTipoDefaultDescripción
itemsComboOption[][]Opciones del dropdown
modelValuestring''Valor seleccionado (v-model)
color'primary' | 'secondary' | 'tertiary' | 'success' | 'warning' | 'danger' | 'light' | 'medium' | 'dark''primary'Color de foco y highlight
placeholderstring'Search...'Placeholder del input
disabledbooleanfalseDeshabilitar interacción

Tokens usados

--bg, --bg-elevated, --border, --text, --font-mono, --color-*