@dcodegroup-au/vue-multiselect
v0.0.7
Published
DcodeGroup's Multi-select wrapper.
Downloads
17
Readme
MultiselectWrapper
Probably the most complete selecting solution for Vue.js 2.0, without jQuery.
This package is a wrapper around VueMultiSelect for our API based implementation. All select options are API generated and additional options for creating options are available as well.
Vue 3.0 Support
For Vue 3.0 compatible version see next
branch.
Documentation
Visit: vue-multiselect.js.org
Features & characteristics:
- Single select
- Multiple select
- Tagging
- Dropdowns
- Filtering
- Search with suggestions
Breaking changes:
- Instead of Vue.partial for custom option templates you can use a custom render function.
- The
:key
props has changed to:track-by
, due to conflicts with Vue 2.0. - Support for
v-model
@update
has changed to@input
to also work with v-model:selected
has changed to:value
for the same reason- Browserify users: if you wish to import
.vue
files, please addvueify
transform.
Install
npm i @dcodegroup-au/vue-multiselect
Configuration Options
- All select options are API generated and additional feature for creating options with the isTaggable props is available along with a createUrl prop.
- This component takes a required searchUrl prop which is an endpoint to a resource which returns a JSON array of objects. The optional label prop will set the option content and must corresponds to a key value from the JSON array items return from the searchUrl.
example.vue.js
<multiselect-wrapper
:value="form.severity"
track-by="id"
label="label"
search-url="/meta/endpoint"
:is-multiple="false"
:is-taggable="false"
@input="val => form.severity = val" // required for receiving updated input values
/>
example.blade.php
<multiselect-wrapper
track-by="id"
label="label"
search-url="/meta/endpoint"
:is-multiple="true"
:is-taggable="false"
:is-form-input="true" // required for form inputs
name="severity" // required for form inputs
></multiselect-wrapper >