v2.0.0-beta.15

Fixes

• #290, #295, #264 Clearing the value should not throw any errors by @pczarn and me

At last!

v2.0.0-beta.14

Important

Styles are now contained inside a separate css file. This should enable usage in SSR apps. It should also make it easier to customize the styles without having redundant CSS rules.
However, you have to add the styles manually. Usually this can be done by adding:

<style src="vue-multiselect/dist/vue-multiselect.min.css"></style>

inside a root component or in the place where vue-multiselect is used or as a static asset along with your component-agnostic CSS code.
When used without a bundler, you can add the file as a static asset with this CDN link:

<style src="https://unpkg.com/vue-multiselect@2.0.0-beta.14/dist/vue-multiselect.min.css"></style>

New

• #136 Options list appear on top if there is no space below the component
• Enable SSR support

Changes

• #164 Refactor single vs multiple selects by @pczarn
• #196 Added warning for conflicting configuration
• #211 noResults slot won’t be displayed if loading is set to true
• #234 Creating a tag when in single-select mode should close the dropdown by @innominata
• Migrated to webpack 2

Fixes:

• #188 Prevent enter submit the form by @slevy85
• #197 New tagging entries are not transformed to lowercase
• #204 Full options list should not flash when the component loses focus
• #190 Closing the multiselect should not cause any isLabel related errors in any case
• #195 Pointer should now correctly point to the first non-label option when using option groups
• #188 Pressing enter key should not submit the form by @slevy85
• #208 Placeholder should now behave correctly in every case
• #187 Search query is no longer trimmed
• #274 Custom search should not interfere with option groups by Eidan Spiegel

v2.0.0-beta.13

Docs:

• New docs https://monterail.github.io/vue-multiselect

Breaking:

• Introduced scoped slots for custom option templates
• Changed :local-search to :internal-search.
• Rebuilt for Vue 2.1.7

v2.0.0-beta.11: Option groups

New:

Support for option groups #111

Example grouped options:

options: [
  {
    label: 'Group A',
    values: [1, 2, 3]
  },
  {
    label: 'Group B',
    values: [4, 5, 6]
  }
}

And here’s how to configure the dropdown.
group-values should point to the property where the option list is located.
group-label should point to the group label.

<multiselect :options="options" group-values="values" group-label="label">

Complete docs soon. :)

Fixed:

#150
#144
#147
#128
#109
#102

v2.0.0-beta.10

Fixed

• Fix #129

v2.0.0-beta.9

New

• Added options-limit prop (expecting a number) that limits the visible options to the first x matching results. By default, the options-limit is set to 1000. This should provide a simple way to improve performance by reducing the number of options rendered. (same as in 1.x)

v2.0.0-beta.8

New:

• Support for v-model based on Form-Input-Components-using-Custom-Events
• CustomLabel function can be applied to both primitives and objects
• LocalSearch prop, to enable local filtering. Disabling it might be useful if you have async search. Default is true.

Breaking changes:

• Instead of Vue.partial for custom option templates you can use a custom render function.
• The :key prop has changed to :track-by, due to conflicts with Vue 2.0.
• @update has changed to @input to also work with v-model
• :selected has changed to :value for the same reason

If your @update handler was only assigning the new value to the model, like for example:

onChange (newVal) {
  this.selected = newVal
}

you can safely change it to just v-model="selected".

v1.1.4

Fix

• #117

New

• #119 customLabel now works on primitive options

Technically it’s not a breaking change but...

If you start seeing [object Object] instead of labels read this:
Previously (for objects list) if label prop was not present, the label calculating method was using option.label as a fallback for creating labels. This is no longer true. This behavior was not documented. If your options are objects, make sure you pass the correct label prop as stated in the docs!

v1.1.3

New

• #102 tab key now selects the hovered option and skips to the next focusable element.
• #94 Added options-limit prop (expecting a number) that limits the visible options to the first x matching results. By default, the options-limit is set to 1000. This should provide a simple way to improve performance by reducing the number of options rendered.

Fixes

• #93
• #101
• #100
• #88

v1.1.2

New

• #79 Introduced :local-search prop, that when set to false disables the local filtering based on search query. Useful for async searches, where you want to show all the returned options.

Fixes

• Fixed regression coming from 1.1.0 (not showing highlight labels).