Autocomplete

The v-autocomplete component offers simple and flexible type-ahead functionality. This is useful when searching large sets of data or even dynamically requesting information from an API.

Uso

The autocomplete component extends v-select and adds the ability to filter items.

API

v-autocomplete
Nombre
allow-overflow
Default
true
Type
boolean

Components.Autocompletes.

Nombre
append-icon
Default
'$vuetify.icons.dropdown'
Type
string

Components.Autocompletes.

Nombre
append-outer-icon New in — v1.1
Default
undefined
Type
string

Components.Autocompletes.

Nombre
attach
Default
false
Type
any

Especifica de cuál elemento del DOM debe soltarse este componente. Utiliza ya sea un selector de CSS o una referencia del objeto que apunta al elemento.

Nombre
auto-select-first
Default
false
Type
boolean

Components.Autocompletes.

Nombre
autofocus
Default
false
Type
boolean

Habilita el autoenfoque

Nombre
background-color
Default
undefined
Type
string

Components.Autocompletes.

Nombre
box
Default
false
Type
boolean

Aplica un estilo alternativo de box al input

Nombre
browser-autocomplete
Default
'off'
Type
string

Components.Autocompletes.

Nombre
cache-items
Default
false
Type
boolean

Mantiene una copia local única de todos los elementos que han sido pasados a través de la prop items

Nombre
chips
Default
false
Type
boolean

Cambia el display de las selecciones a chips

Nombre
clear-icon
Default
'$vuetify.icons.clear'
Type
string

Components.Autocompletes.

Nombre
clearable
Default
false
Type
boolean

Agrega funcionalidad de limpiar el input, el ícono default es clear de Material Icons

Nombre
color
Default
'primary'
Type
string

Aplica el color especificado al control.

Nombre
counter
Default
undefined
Type
boolean | number | string

Crea un contador para la longitud del input. Si no se especifica un número, el default es 25. No aplica ninguna validación.

Nombre
dark
Default
false
Type
boolean

Aplica la variante del tema dark

Nombre
deletable-chips
Default
false
Type
boolean

Agrega un ícono de quitar a los chips seleccionados

Nombre
dense
Default
false
Type
boolean

Reduce la altura máxima de los elementos de la lista

Nombre
disabled
Default
false
Type
boolean

Components.Autocompletes.

Nombre
dont-fill-mask-blanks
Default
false
Type
boolean

Deshabilita que el caracter se muestre en automático al escribir

Nombre
error
Default
false
Type
boolean

Pone el input en un estado de error manual

Nombre
error-count
Default
1
Type
number | string

Components.Autocompletes.

Nombre
error-messages
Default
[]
Type
string | array

Pone el input en un estado de error y pasa los mensajes de error personalizados. Se combinará con cualquier validación que ocurra desde la prop rules. Este campo no propicia ninguna validación.

Nombre
filter
Default
(item: object, queryText: string, itemText: string) => boolean
Type
function

Components.Autocompletes.

Nombre
flat
Default
false
Type
boolean

Components.Autocompletes.

Nombre
full-width
Default
false
Type
boolean

Indica el tipo del input como un full-width (ancho total)

Nombre
height
Default
undefined
Type
number | string

Configura la altura del componente

Nombre
hide-details
Default
false
Type
boolean

Components.Autocompletes.

Nombre
hide-no-data
Default
false
Type
boolean

Components.Autocompletes.

Nombre
hide-selected
Default
false
Type
boolean

No mostrar elementos en las opciones que ya hayan sido seleccionados

Nombre
hint
Default
undefined
Type
string

Components.Autocompletes.

Nombre
item-avatar
Default
avatar
Type
string | array | function

Configura el avatar del elemento

Nombre
item-disabled
Default
disabled
Type
string | array | function

Determina si el elemento está deshabilitado

Nombre
item-text
Default
text
Type
string | array | function

Configura el texto del elemento

Nombre
item-value
Default
value
Type
string | array | function

Configura el valor del elemento

Nombre
items
Default
[]
Type
array

Puede ser un arreglo de objetos o un arreglo de strings. Cuando se usan objetos, buscará por campos text y field. Esto puede cambiarse usando las props item-text y item-value

Nombre
label
Default
undefined
Type
string

Components.Autocompletes.

Nombre
light
Default
false
Type
boolean

Aplica la variante del tema light

Nombre
loading
Default
false
Type
boolean | string

Components.Autocompletes.

Nombre
mask
Default
undefined
Type
object | string

Aplica un caracter personalizado como máscara del input. Ve a la tabla de máscaras arriba para mayor información

Nombre
menu-props New in — v1.2
Default
{"closeOnClick":false, "closeOnContentClick":false, "openOnClick":false, "maxHeight":300}
Type
string | array | object

Components.Autocompletes.

Nombre
messages
Default
[]
Type
string | array

Components.Autocompletes.

Nombre
multiple
Default
false
Type
boolean

Cambia a múltiple. Acepta un arreglo.

Nombre
no-data-text
Default
'$vuetify.noDataText'
Type
string

El texto a mostrar cuando no hay datos.

Nombre
no-filter New in — v1.1
Default
false
Type
boolean

Components.Autocompletes.

Nombre
open-on-clear
Default
false
Type
boolean

Cuando se usa la prop clearable y ha sido limpiado, el menu del select se abrirá o permanecerá abierto, dependiendo del estado actual

Nombre
outline
Default
false
Type
boolean

Components.Autocompletes.

Nombre
persistent-hint
Default
false
Type
boolean

Components.Autocompletes.

Nombre
placeholder
Default
undefined
Type
string

Components.Autocompletes.

Nombre
prefix
Default
undefined
Type
string

Muestra un texto de prefijo

Nombre
prepend-icon
Default
undefined
Type
string

Components.Autocompletes.

Nombre
prepend-inner-icon New in — v1.1
Default
undefined
Type
string

Components.Autocompletes.

Nombre
readonly
Default
false
Type
boolean

Components.Autocompletes.

Nombre
return-masked-value
Default
false
Type
boolean

Regresa la cadena que fue enmascarada sin modificar

Nombre
return-object
Default
false
Type
boolean

Cambia el comportamiento al seleccionar para que regrese un objeto directamente en lugar del valor especificado con item-value

Nombre
reverse New in — v1.1
Default
false
Type
boolean

Components.Autocompletes.

Nombre
rules
Default
[]
Type
array

Arreglo de funciones que regresa ya sea True o un String con el mensaje de error

Nombre
search-input
Default
undefined
Type
any

Ligado cuando se usa la prop autocomplete. Utiliza el modificador .sync para leer lo que el usuario escribe desde el input de búscada para autocompletar.

Nombre
single-line
Default
false
Type
boolean

La etiqueta no se mueve en los eventos focus/dirty

Nombre
small-chips New in — v1.1
Default
false
Type
boolean

Components.Autocompletes.

Nombre
solo
Default
false
Type
boolean

Components.Autocompletes.

Nombre
solo-inverted
Default
false
Type
boolean

Components.Autocompletes.

Nombre
success New in — v1.1
Default
false
Type
boolean

Components.Autocompletes.

Nombre
success-messages New in — v1.1
Default
[]
Type
string | array

Components.Autocompletes.

Nombre
suffix
Default
undefined
Type
string

Muestra un texto de sufijo

Nombre
type
Default
'text'
Type
string

Configura el tipo de input

Nombre
validate-on-blur
Default
false
Type
boolean

Retrasa la validación hasta el evento blur

Nombre
value
Default
undefined
Type
any

Controla la visibilidad

Nombre
value-comparator
Default
(a: any, b: any) => boolean
Type
function

Components.Autocompletes.

Suplementos

Mask legend
MaskDescription
Masks
#Any digit
AAny capital letter
aAny small letter
NAny capital alphanumeric character
nAny small alphanumeric character
XAny special symbol (-!$%^&*()_+|~=`{}[]:";'<>?,./\) or space
Pre-made
credit-card#### - #### - #### - ####
date-with-time##/##/#### ##:##
phone(###) ### - ####
social###-##-####
time##:##
time-with-seconds##:##:##

Ejemplos

Searching an API

Easily hook up dynamic data and create a unique experience. The v-autocomplete's expansive prop list makes it easy to fine tune every aspect of the input.

Scoped slots

With the power of scoped slots, you can customize the visual output of the select. In this example we add a profile picture for both the chips and list items.

Custom filter on autocomplete

The filter prop can be used to filter each individual item with custom logic. In this example we filter items by name

Asynchronous items

Sometimes you need to load data externally based upon a search query. Use the search-input prop with the .sync modifier when using the autocomplete prop. We also make use of the new cache-items prop. This will keep a unique list of all items that have been passed to the items prop and is REQUIRED when using asynchronous items and the multiple prop.

Advanced slots

The v-autocomplete component is extremely flexible and can fit in just about any use-case. Create custom displays for no-data, item and selection slots to provide a unique user experience. Using scoped slots enables you to easily customize the desired look for your application.

Edit this page | language on Github
Vuetify 3 is now available!The latest version of Vuetify is now available!
Learn about Vuetify 3's new features and functionality for modern Vue applications
Start exploringExplore