Merge branch 'master' into gitbook

# Conflicts:
#	docs/md/OnChange.md

docs/md/OnChange.md

@@ -0,0 +1,26 @@
+### Change Event <small>Vuex Compatibility</small>
+
+vue-select provides a `change` event. This function is passed the currently selected value(s) as it's only parameter.
+
+This is very useful when integrating with Vuex, as it will allow your to trigger an action to update your vuex state object. Choose a callback and see it in action.
+
+<div class="form-inline">
+<div class="radio"><label><input type="radio" v-model="callback" value="console"> `console.log(val)`</label> </div>
+<div class="radio"><label><input type="radio" v-model="callback" value="alert"> `alert(val)`</label> </div>
+</div>
+
+```html
+<v-select :on-change="consoleCallback" :options="countries"></v-select>
+```
+
+```js
+methods: {
+  consoleCallback(val) {
+    console.dir(JSON.stringify(val))
+  },
+
+  alertCallback(val) {
+    alert(JSON.stringify(val))
+  }
+}
+```