Select

Select fields components are used for collecting user provided information from a list of options.

API

v-select
Nome
append-icon
Padrão
'$vuetify.icons.dropdown'
Tipos
string

Components.Selects.

Nome
append-outer-icon New in — v1.1
Padrão
undefined
Tipos
string

Components.Selects.

Nome
attach
Padrão
false
Tipos
any

Components.Selects.

Nome
autofocus
Padrão
false
Tipos
boolean

Habilita focagem automática

Nome
background-color
Padrão
undefined
Tipos
string

Components.Selects.

Nome
box
Padrão
false
Tipos
boolean

Aplica o estilo em caixa alternativo para o campo de entrada

Nome
browser-autocomplete
Padrão
'on'
Tipos
string

Components.Selects.

Nome
cache-items
Padrão
false
Tipos
boolean

Components.Selects.

Nome
chips
Padrão
false
Tipos
boolean

Components.Selects.

Nome
clear-icon
Padrão
'$vuetify.icons.clear'
Tipos
string

Components.Selects.

Nome
clearable
Padrão
false
Tipos
boolean

Adicionar a funcionalidade de limpar o input, ícone padrão é usa o clear do Material Icons

Nome
color
Padrão
'primary'
Tipos
string

Components.Selects.

Nome
counter
Padrão
undefined
Tipos
boolean | number | string

Cria um contador para o tamanho da entrada. O padrão é 25 se nenhum número for especificado. Não é aplicada nenhuma validação.

Nome
dark
Padrão
false
Tipos
boolean

Components.Selects.

Nome
deletable-chips
Padrão
false
Tipos
boolean

Components.Selects.

Nome
dense
Padrão
false
Tipos
boolean

Components.Selects.

Nome
disabled
Padrão
false
Tipos
boolean

Components.Selects.

Nome
dont-fill-mask-blanks
Padrão
false
Tipos
boolean

Desativa a exibição automática de caracteres ao digitar

Nome
error
Padrão
false
Tipos
boolean

Components.Selects.

Nome
error-count
Padrão
1
Tipos
number | string

Components.Selects.

Nome
error-messages
Padrão
[]
Tipos
string | array

Components.Selects.

Nome
flat
Padrão
false
Tipos
boolean

Components.Selects.

Nome
full-width
Padrão
false
Tipos
boolean

Designa o tipo da entrada com largura total

Nome
height
Padrão
undefined
Tipos
number | string

Define a altura do componente

Nome
hide-details
Padrão
false
Tipos
boolean

Components.Selects.

Nome
hide-selected
Padrão
false
Tipos
boolean

Components.Selects.

Nome
hint
Padrão
undefined
Tipos
string

Components.Selects.

Nome
item-avatar
Padrão
avatar
Tipos
string | array | function

Components.Selects.

Nome
item-disabled
Padrão
disabled
Tipos
string | array | function

Components.Selects.

Nome
item-text
Padrão
text
Tipos
string | array | function

Components.Selects.

Nome
item-value
Padrão
value
Tipos
string | array | function

Components.Selects.

Nome
items
Padrão
[]
Tipos
array

Components.Selects.

Nome
label
Padrão
undefined
Tipos
string

Components.Selects.

Nome
light
Padrão
false
Tipos
boolean

Components.Selects.

Nome
loading
Padrão
false
Tipos
boolean | string

Components.Selects.

Nome
mask
Padrão
undefined
Tipos
object | string

Aplica uma máscara personalizada no input. Para mais informações, veja a tabela de máscaras abaixo

Nome
menu-props New in — v1.2
Padrão
{"closeOnClick":false, "closeOnContentClick":false, "openOnClick":false, "maxHeight":300}
Tipos
string | array | object

Components.Selects.

Nome
messages
Padrão
[]
Tipos
string | array

Components.Selects.

Nome
multiple
Padrão
false
Tipos
boolean

Components.Selects.

Nome
no-data-text
Padrão
'$vuetify.noDataText'
Tipos
string

Components.Selects.

Nome
open-on-clear
Padrão
false
Tipos
boolean

Components.Selects.

Nome
outline
Padrão
false
Tipos
boolean

Components.Selects.

Nome
persistent-hint
Padrão
false
Tipos
boolean

Components.Selects.

Nome
placeholder
Padrão
undefined
Tipos
string

Components.Selects.

Nome
prefix
Padrão
undefined
Tipos
string

Exibe um texto como prefixo

Nome
prepend-icon
Padrão
undefined
Tipos
string

Components.Selects.

Nome
prepend-inner-icon New in — v1.1
Padrão
undefined
Tipos
string

Components.Selects.

Nome
readonly
Padrão
false
Tipos
boolean

Components.Selects.

Nome
return-masked-value
Padrão
false
Tipos
boolean

Retorna a string mascarada não modificada

Nome
return-object
Padrão
false
Tipos
boolean

Components.Selects.

Nome
reverse New in — v1.1
Padrão
false
Tipos
boolean

Components.Selects.

Nome
rules
Padrão
[]
Tipos
array

Components.Selects.

Nome
single-line
Padrão
false
Tipos
boolean

Label não se move em eventos focus/dirty

Nome
small-chips New in — v1.1
Padrão
false
Tipos
boolean

Components.Selects.

Nome
solo
Padrão
false
Tipos
boolean

Components.Selects.

Nome
solo-inverted
Padrão
false
Tipos
boolean

Components.Selects.

Nome
success New in — v1.1
Padrão
false
Tipos
boolean

Components.Selects.

Nome
success-messages New in — v1.1
Padrão
[]
Tipos
string | array

Components.Selects.

Nome
suffix
Padrão
undefined
Tipos
string

Exibe um texto como sufixo

Nome
type
Padrão
'text'
Tipos
string

Seta o tipo do campo de entrada

Nome
validate-on-blur
Padrão
false
Tipos
boolean

Components.Selects.

Nome
value
Padrão
undefined
Tipos
any

Controla visibilidade

Nome
value-comparator
Padrão
(a: any, b: any) => boolean
Tipos
function

Components.Selects.

Suplementar

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##:##:##

Exemplos

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