Autocompletado

Puede obtener algunas sugerencias basadas en la entrada actual.

Uso básico

El componente Autocompletar proporciona sugerencias de entrada.

El atributo fetch-suggestions es un método que devuelve sugerencias de entrada. En este ejemplo, querySearch(queryString, cb) devuelve sugerencias a Autocompletar vía cb(data) cuando las sugerencias están listas.

list suggestions when activated
list suggestions on input

Template personalizado

Personalice cómo se muestran las sugerencias.

Utilice scoped slot para personalizar los elementos de sugerencias. En el scope, puede acceder al objeto de sugerencia mediante la clave item.

Búsqueda remota

Búsqueda de datos desde el servidor.

Custom Loading 2.5.0

Override loading content.

loading icon1
loading icon2

API

Atributos

NombreDescripciónTipoPor defecto
model-value / v-modelvalor enlazadostring
placeholderel placeholder del autocompletadostring
clearablesi desea mostrar el botón de borrarbooleanfalse
disabledsi el autocompletado está deshabilitadobooleanfalse
value-keynombre clave del objeto de sugerencia para mostrar en el inputstringvalue
debounceretraso de desconexión al teclear, en milisegundosnumber300
placementposición del menú emergenteenumbottom-start
fetch-suggestionsun método para obtener sugerencias del input. Cuando las sugerencias están listas, invoca callback(data:[]) para devolverlas a AutocompletarArray / Function
trigger-on-focussi mostrar sugerencias cuando el input tenga el focobooleantrue
select-when-unmatchedsi se quiere emitir un evento select cuando no hay coincidencia de autocompletadobooleanfalse
namecomo name en el input nativostring
aria-label a11y 2.7.2native aria-label attributestring
hide-loadingsi se oculta el icono de load en la búsqueda remotabooleanfalse
popper-classnombre de clase personalizado para el menú desplegable de autocompletadostring
teleportedsi el desplegable de selección se teletransporta al bodybooleantrue
highlight-first-itemsi por defecto se destacara el primer elemento en las sugerencias de búsqueda remotabooleanfalse
fit-input-widthsi el ancho del desplegable es el mismo que el del inputbooleanfalse
popper-append-to-body deprecatedsi añadir el menú desplegable al body. Si la posición del desplegable es incorrecta, puede intentar establecer esta propiedad a falsebooleanfalse

Eventos

NombreDescripciónTipo
blurtriggers when Input blursFunction
focustriggers when Input focusesFunction
inputtriggers when the Input value changeFunction
cleartriggers when the Input is cleared by clicking the clear buttonFunction
selectse dispara cuando se hace clic en una sugerenciaFunction
changese dispara cuando el icono dentro del valor de entrada cambiaFunction

Slots

NombreDescripciónTipo
defaultcustom content for input suggestionsobject
prefixcontenido como prefijo del input-
suffixcontenido como sufijo del input-
prependcontenido a anteponer al input-
appendcontenido para añadir después del input-
loading 2.5.0override loading content-

Expuesto

NombreDescripciónType
activatedsi se activa el autocompletadoobject
blurquita el foco en el inputFunction
closecontraer lista de sugerenciasFunction
focuscoloca el foco en el elementoFunction
handleSelectse dispara cuando se hace clic en una sugerenciaFunction
handleKeyEntermanejar evento de entrada de tecladoFunction
highlightedIndexel índice del elemento actualmente destacadoobject
highlightdestacar un elemento en una sugerenciaFunction
inputRefinstancia del componente el-inputobject
loadingindicador de carga de búsqueda remotaobject
popperRefinstancia del componente el-tooltipobject
suggestionsobtener resultados de sugerenciasobject
getData 2.8.4loading suggestion listFunction

Fuente

ComponentesStyleDocumentación

Contribuidores