Field select
The field is used to select a single value from the provided set.
- Keyword
select
. - WhatWG Specification.
Params
options Required
- Type: FormFieldOptions.
The set of possible field values.
hiddenValues Optional
- Type:
any[]
If this array is specified, then the selection will not contain the elements specified in hiddenValues
.
placeholder Optional
- Type:
string
If no value is selected, a text label is shown.
Also, all parameters common to all FormField
. Information about them can be viewed on this page.
Value
On clicking or selecting the corresponding select
element, the value will be set to according to the value in the value
field of the passed options
.
Specification
- The object is available for access via
Tab
andShift + Tab
. - Moving around the object is possible using
ArrowDown
andArrowUp
. Moving this way changes the value of a field. - Selecting an element is possible by clicking on the corresponding element.
- Cannot select an element using
Enter
orSpace
. - Using
Enter
orSpace
expands or closes the dropdown list. - An additional search controller is shown for a long list.
- Blocking fields cancels navigation using
Tab
. There is also a change in the style ofselect
. - If the validation fails, the field should change the style of the
select
.
Examples
To connect a widget, you need to specify type
and options
:
<form-field :options="companies" type="select"/>
<form-field :options="companies" type="select"/>
import {FormField} from "jenesius-vue-form";
const companies = {
'a': "Apple",
'h': "Huawei",
's': "Samsung"
};
const colors = {
white: 'White',
black: 'Black',
red: 'Red',
yellow: 'Yellow',
orange: 'Orange',
green: 'Green',
blue: 'Blue',
purple: 'Purple',
pink: 'Pink',
brown: 'Brown',
grey: 'Grey',
};
import {FormField} from "jenesius-vue-form";
const companies = {
'a': "Apple",
'h': "Huawei",
's': "Samsung"
};
const colors = {
white: 'White',
black: 'Black',
red: 'Red',
yellow: 'Yellow',
orange: 'Orange',
green: 'Green',
blue: 'Blue',
purple: 'Purple',
pink: 'Pink',
brown: 'Brown',
grey: 'Grey',
};
Default field:
Select one item
In locked state:
Disabled
Field not validated:
With Error
Seleact this fields
A field with many options
. The search controller should be displayed:
A large number of colors
Using hiddenValues
and setting the value to ['blue', 'purple', 'pink', 'brown', 'grey']
:
Filtered colors
The current state of the form:
{}
{}