Select

Selects with a clean and smooth animation, that are very easy to implement.

Single selection

To add a select to the application we have the component vs-select. You can customize the arrow icon by passing an icon name to icon.

TIP

Vuesax uses the Google Material Icons font library. For a list of all available icons, visit the official Material Icons pageopen in new window.

FontAwesome and other fonts library are supported. Simply use the icon-pack with fa or fas. You still need to include the Font Awesome icons in your project.

keyboard_arrow_down
keyboard_arrow_down
keyboard_arrow_down
arrow_downward

Color

You can change the color of the select with the property color

WARNING

Only RGB and HEX colors are supported.

keyboard_arrow_down
keyboard_arrow_down

Autocomplete

You can add the autocomplete functionality in the desired selected with the property autocomplete.

keyboard_arrow_down
keyboard_arrow_down
keyboard_arrow_down

Multiple

You can have a selection with multiple selections with the property multiple. If you need the user to select only a certain number of options you can use the property max-selected.

keyboard_arrow_down
keyboard_arrow_down
keyboard_arrow_down

Labels

Add a label to the input with the property label.

keyboard_arrow_down
keyboard_arrow_down

Validators

You can add a state for example of in affirmative response to a validation with success and if it is necessary to add a description or help to the user you can do it with the property description

TIP

Each of the states you can change the text, for example in the case of danger-text for the state of danger.

keyboard_arrow_down
This field is valid
keyboard_arrow_down
This field is invalid
keyboard_arrow_down
This field is invalid
keyboard_arrow_down
Simple info for multiple select

Is Selected Item

You can validate if an option is selected with the property is-selected.sync and do with it multiple variants with changing the text of the selected options

keyboard_arrow_down

Group items

You can group elements with the sub component vs-select-group

keyboard_arrow_down
keyboard_arrow_down
keyboard_arrow_down

Width

You can set the width of the select width the width property

keyboard_arrow_down
keyboard_arrow_down

API #

NameTypeParametersDescriptiondefault
optionsArray{ "text:'Example'": null, "value:'1'": null }Options to select.
colorStringChange the color of the buttonprimary
autocompleteBooleanEnables the use of autocomplete in the select.false
multipleBooleanDetermines whether the selection is of multiple selection.false
max-selectedNumberDetermine the number of maximum options to be able to select (only for active multiple).All options
labelStringLabel for the input element.
successBooleanboolean bindActivate the status of success in the input.false
dangerBooleanboolean bindActivate the status of danger in the input.false
warningBooleanboolean bindActivate the status of warning in the input.false
description-textStringAdd a description text to the input.false
danger-textStringText to show when the item is invalid.
success-textStringText to show when the item is valid.
warning-textStringText that is displayed in the warning state.
is-selected.syncBoolean syncDetermines if the option is selected.
input-changedEventevent (optional)Triggers method when input of select is changed (requires autocomplete prop)
widthStringSet the width of the select
iconStringicon nameElement icon.keyboard_arrow_down
icon-packStringIcon Pack Class NameIcon Pack to be used. If not set, icon will default to Material Icons. ex. FA4 uses fa or fas, FA5 uses fas, far, or fal.material-icons