Select

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

API

props
slots
scoped Slots
events
v-select
Name
append-icon
Default
'$vuetify.icons.dropdown'
Type
string

Components.Selects.

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

Components.Selects.

Name
attach
Default
false
Type
any

Components.Selects.

Name
autofocus
Default
false
Type
boolean

Components.Selects.

Name
background-color
Default
undefined
Type
string

Components.Selects.

Name
box
Default
false
Type
boolean

Components.Selects.

Name
browser-autocomplete
Default
'on'
Type
string

Components.Selects.

Name
cache-items
Default
false
Type
boolean

Components.Selects.

Name
chips
Default
false
Type
boolean

Components.Selects.

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

Components.Selects.

Name
clearable
Default
false
Type
boolean

Components.Selects.

Name
color
Default
'primary'
Type
string

コンポーネントに色を設定します。この色は、定義されている色の名前（例えばsuccessやpurple）や、CSSの色指定（#033やrgba(255, 0, 0, 0.5)）を設定できます。

Name
counter
Default
undefined
Type
boolean | number | string

Components.Selects.

Name
dark
Default
false
Type
boolean

ダークテーマを適用します。

Name
deletable-chips
Default
false
Type
boolean

Components.Selects.

Name
dense
Default
false
Type
boolean

Components.Selects.

Name
disabled
Default
false
Type
boolean

Components.Selects.

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

Components.Selects.

Name
error
Default
false
Type
boolean

Components.Selects.

Name
error-count
Default
1
Type
number | string

Components.Selects.

Name
error-messages
Default
[]
Type
string | array

Components.Selects.

Name
flat
Default
false
Type
boolean

Components.Selects.

Name
full-width
Default
false
Type
boolean

Components.Selects.

Name
height
Default
undefined
Type
number | string

Components.Selects.

Name
hide-details
Default
false
Type
boolean

Components.Selects.

Name
hide-selected
Default
false
Type
boolean

Components.Selects.

Name
hint
Default
undefined
Type
string

Components.Selects.

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

Components.Selects.

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

Components.Selects.

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

Components.Selects.

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

Components.Selects.

Name
items
Default
[]
Type
array

Components.Selects.

Name
label
Default
undefined
Type
string

Components.Selects.

Name
light
Default
false
Type
boolean

ライトテーマを適用します。

Name
loading
Default
false
Type
boolean | string

Components.Selects.

Name
mask
Default
undefined
Type
object | string

Components.Selects.

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

Components.Selects.

Name
messages
Default
[]
Type
string | array

Components.Selects.

Name
multiple
Default
false
Type
boolean

Components.Selects.

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

Components.Selects.

Name
open-on-clear
Default
false
Type
boolean

Components.Selects.

Name
outline
Default
false
Type
boolean

Components.Selects.

Name
persistent-hint
Default
false
Type
boolean

Components.Selects.

Name
placeholder
Default
undefined
Type
string

Components.Selects.

Name
prefix
Default
undefined
Type
string

Components.Selects.

Name
prepend-icon
Default
undefined
Type
string

Components.Selects.

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

Components.Selects.

Name
readonly
Default
false
Type
boolean

Components.Selects.

Name
return-masked-value
Default
false
Type
boolean

Components.Selects.

Name
return-object
Default
false
Type
boolean

Components.Selects.

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

Components.Selects.

Name
rules
Default
[]
Type
array

Components.Selects.

Name
single-line
Default
false
Type
boolean

Components.Selects.

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

Components.Selects.

Name
solo
Default
false
Type
boolean

Components.Selects.

Name
solo-inverted
Default
false
Type
boolean

Components.Selects.

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

Components.Selects.

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

Components.Selects.

Name
suffix
Default
undefined
Type
string

Components.Selects.

Name
type
Default
'text'
Type
string

Components.Selects.

Name
validate-on-blur
Default
false
Type
boolean

Components.Selects.

Name
value
Default
undefined
Type
any

Components.Selects.

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

Components.Selects.

Supplemental

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

Examples

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
 — Contribution Guide
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