diff --git a/docs/.vuepress/components/ReducedWithNoMatchingOption.vue b/docs/.vuepress/components/ReducedWithNoMatchingOption.vue
new file mode 100644
index 0000000..d6e3daa
--- /dev/null
+++ b/docs/.vuepress/components/ReducedWithNoMatchingOption.vue
@@ -0,0 +1,20 @@
+
+
+
+
+
diff --git a/docs/guide/values.md b/docs/guide/values.md
index 2d664ae..5a82bfd 100644
--- a/docs/guide/values.md
+++ b/docs/guide/values.md
@@ -2,11 +2,12 @@
### `v-model`
-The most common use case for vue-select is to have the chosen value synced with a parent component. vue-select
-takes advantage of the `v-model` syntax to sync values with a parent. The `v-model` syntax works with
-primitives and objects.
+The most common use case for vue-select is to have the chosen value synced with a parent component.
+vue-select takes advantage of the `v-model` syntax to sync values with a parent. The `v-model`
+syntax works with primitives and objects.
```html
+
```
@@ -14,25 +15,26 @@ Note that when using the `multiple` prop, the `v-model` value will always be an
### Props and Events
-Sometimes `v-model` might not fit your use case. For example, when working with [Vuex](https://vuex.vuejs.org),
-you'll need to trigger a mutation rather than mutating a value directly. In that case, maybe you need
-to bind a pre-selected value, and trigger a mutation when it changes.
+Sometimes `v-model` might not fit your use case. For example, when working
+with [Vuex](https://vuex.vuejs.org), you'll need to trigger a mutation rather than mutating a value
+directly. In that case, maybe you need to bind a pre-selected value, and trigger a mutation when it
+changes.
-vue-select exposes the `value` prop and an `input` event to enable this. This combo of props and
+vue-select exposes the `value` prop and an `input` event to enable this. This combo of props and
events is also how Vue wires up the `v-model` syntax internally.
#### Prop: `value`
-The `value` prop lets vue-select know what value is currently selected. It will accept strings,
-numbers or objects. If you're using a `multiple` v-select, you'll want to pass an array.
+The `value` prop lets vue-select know what value is currently selected. It will accept strings,
+numbers or objects. If you're using a `multiple` v-select, you'll want to pass an array.
```html
+
```
-::: tip 🤓
-Anytime you bind the `value` prop directly, you're responsible for updating the bound variable
-in your code using the `@input` event.
+::: tip 🤓 Anytime you bind the `value` prop directly, you're responsible for updating the bound
+variable in your code using the `@input` event.
:::
#### Event: `input`
@@ -42,50 +44,66 @@ state as it's only parameter.
#### Vuex Support
-The `value` prop and `emit` event are very useful when using a state management tool, like Vuex.
-You can bind the selected value with `:value="$store.myValue"`, and use the `input` event to
-trigger a mutation, or dispatch an action – or anything else you might need to do when the selection
-changes.
+The `value` prop and `emit` event are very useful when using a state management tool, like Vuex. You
+can bind the selected value with `:value="$store.myValue"`, and use the `input` event to trigger a
+mutation, or dispatch an action – or anything else you might need to do when the selection changes.
```html
+
```
```js
methods: {
- setSelected(value) {
- // trigger a mutation, or dispatch an action
- }
+ setSelected(value)
+ {
+ // trigger a mutation, or dispatch an action
+ }
}
```
+
+## Single/Multiple
+
+By default, vue-select supports choosing a single value. If you need multiple values, use the
+`multiple` boolean prop, much the same way you would on an HTML `