Select

Los componentes select fields son utilizados para recolectar información provista por el usuario de una lista de opciones.

API

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

Components.Selects.

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

Components.Selects.

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
autofocus
Default
false
Type
boolean

Habilita el autoenfoque

Nombre
background-color
Default
undefined
Type
string

Components.Selects.

Nombre
box
Default
false
Type
boolean

Aplica un estilo alternativo de box al input

Nombre
browser-autocomplete
Default
'on'
Type
string

Configura la prop de autocompletar para cuando el usuario escribe

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.Selects.

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

Deshabilita el input

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.Selects.

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
flat
Default
false
Type
boolean

Components.Selects.

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.Selects.

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.Selects.

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.Selects.

Nombre
light
Default
false
Type
boolean

Aplica la variante del tema light

Nombre
loading
Default
false
Type
boolean | string

Components.Selects.

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.Selects.

Nombre
messages
Default
[]
Type
string | array

Components.Selects.

Nombre
multiple
Default
false
Type
boolean

Cambia a múltiple. Acepta un arreglo.

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

Texto a mostrar cuando no hay datos

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.Selects.

Nombre
persistent-hint
Default
false
Type
boolean

Components.Selects.

Nombre
placeholder
Default
undefined
Type
string

Components.Selects.

Nombre
prefix
Default
undefined
Type
string

Muestra un texto de prefijo

Nombre
prepend-icon
Default
undefined
Type
string

Components.Selects.

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

Components.Selects.

Nombre
readonly
Default
false
Type
boolean

Components.Selects.

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.Selects.

Nombre
rules
Default
[]
Type
array

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

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.Selects.

Nombre
solo
Default
false
Type
boolean

Components.Selects.

Nombre
solo-inverted
Default
false
Type
boolean

Components.Selects.

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

Components.Selects.

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

Components.Selects.

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.Selects.

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

Light theme

A standard single select has a multitude of configuration options.

Icons

Use a custom prepended or appended icon.

Multiple

A multi-select can utilize v-chip as the display for selected items.

Customized item text and value

You can specify the specific properties within your items array correspond to the text and value fields. By default, this is text and value. In this example we also use the return-object prop which will return the entire object of the selected item on selection.

Prepend/Append item slots

The v-select components can be optionally expanded with prepended and appended items. This is perfect for customized select-all functionality.

Change selection appearance

The selection scoped slot can be used to customize the way selected values are shown in the input. This is great when you want something like foo (+20 others) or don't want the selection to occupy multiple lines.

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