Merge branch 'master' into master

adi518 · web-flow · commit da5c6baa2863 · 2018-08-09T19:23:52.000+03:00
diff --git a/README.md b/README.md
@@ -2,6 +2,8 @@
 
 > A native Vue.js select component that provides similar functionality to Select2 without the overhead of jQuery.
 
+Want to help out as a primary contributor? [Get in touch](https://github.com/sagalbot/vue-select/issues/581)!
+
 #### Features
 - AJAX Support
 - Tagging
@@ -104,3 +106,7 @@ When provided an array of objects, `vue-select` will display a single value of t
 ```
 
 ### For more information, please visit the [vue-select documentation.](https://sagalbot.github.io/vue-select)
+
+## License
+
+[MIT](https://github.com/sagalbot/vue-select/blob/master/LICENSE.md)
diff --git a/dev/dev.html b/dev/dev.html
@@ -9,7 +9,7 @@
     <!--<link href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap.min.css" rel="stylesheet">-->
     <!--<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.0.0/css/bootstrap.min.css">-->
     <style>
-        
+
         #app {
             height: 95vh;
             display: flex;
@@ -67,7 +67,7 @@
               </button>
             </span>
         </v-select>
-
+        <v-select placeholder="select on tab" :select-on-tab="true" :options="options"></v-select>
         <v-select placeholder="disabled" disabled  value="disabled"></v-select>
         <v-select placeholder="disabled multiple" disabled multiple :value="['disabled', 'multiple']"></v-select>
         <v-select placeholder="filterable=false, @search=searchPeople" label="first_name" :filterable="false" @search="searchPeople" :options="people"></v-select>
diff --git a/docs/gitbook/Basics/Options.md b/docs/gitbook/Basics/Options.md
@@ -33,6 +33,27 @@ If you wanted to display `Canada` in the dropdown, you'd use the `countryName` k
 
 [](codepen://sagalbot/aEjLPB?height=500)
 
+
+### Option index {#values}
+
+When the `options` array contains objects, `vue-select` returns the whole object as dropdown value upon selection. You can specify your own `index` prop to return only the value contained in the specific property.
+
+For example, consider an object with `value` and `label` properties:
+
+```json
+{
+  value: "CA",
+  label: "Canada"
+}
+```
+
+If you wanted to return `CA` in the dropdown when `Canada` is selected, you'd use the `index` key:
+
+```html
+<v-select index="value" :options="countries"></v-select>
+```
+
+
 ### Null / Empty Options {#null}
 
 `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 `[]`.
diff --git a/docs/gitbook/README.md b/docs/gitbook/README.md
@@ -22,4 +22,5 @@
 
 #### Resources
 - **[CodePen Template](http://codepen.io/sagalbot/pen/NpwrQO)**
-- **[Trello Roadmap](https://trello.com/b/vWvITNzS/vue-select)**
+- **[Trello Roadmap](https://trello.com/b/vWvITNzS/vue-select)**
+- **[GitHub](https://github.com/sagalbot/vue-select)**
diff --git a/src/components/Select.vue b/src/components/Select.vue
diff --git a/test/unit/specs/Select.spec.js b/test/unit/specs/Select.spec.js
