mirror of
https://github.com/tenrok/vue-select.git
synced 2026-05-20 03:09:36 +03:00
Jeff
7e859dca18
- adjust default codepen theme - update github edit base - doc content overhaul up to localization
39 lines
1.3 KiB
Markdown
39 lines
1.3 KiB
Markdown
## Dropdown Options {#options}
|
|
|
|
`vue-select` accepts arrays of strings or objects to use as options through the `options` prop:
|
|
|
|
```html
|
|
<v-select :options="['foo','bar']"></v-select>
|
|
```
|
|
|
|
When provided an array of objects, `vue-select` will display a single value of the object. By default, `vue-select` will look for a key named `label` on the object to use as display text.
|
|
|
|
```html
|
|
<v-select :options="[{label: 'foo', value: 'Foo'}]"></v-select>
|
|
```
|
|
|
|
### Option Labels {#labels}
|
|
|
|
When the `options` array contains objects, `vue-select` looks for the `label` key to display by default. You can set your own label to match your source data using the `label` prop.
|
|
|
|
For example, consider an object with `countryCode` and `countryName` properties:
|
|
|
|
```json
|
|
{
|
|
countryCode: "CA",
|
|
countryName: "Canada"
|
|
}
|
|
```
|
|
|
|
If you wanted to display `Canada` in the dropdown, you'd use the `countryName` key:
|
|
|
|
```html
|
|
<v-select label="countryName" :options="countries"></v-select>
|
|
```
|
|
|
|
[](codepen://sagalbot/aEjLPB?height=500)
|
|
|
|
### Null / Empty Options {#emptyOptions}
|
|
|
|
`vue-select` requires the `option` property to be an `array`. If you are using Vue in development mode, you will get warnings attempting to pass anything other than an `array` to the `options` prop. If you need a `null`/`empty` value, use an empty array `[]`.
|