vue-select/docs/README.md

# Vue Select

![Build Status](https://travis-ci.org/sagalbot/vue-select.svg?branch=master)
![Monthly Downloads](https://img.shields.io/npm/dm/vue-select.svg?style=flat-square) 
![Maintainability Score](https://img.shields.io/codeclimate/maintainability/sagalbot/vue-select.svg?style=flat-square) 
![MIT License](https://img.shields.io/github/license/sagalbot/vue-select.svg?style=flat-square) 
![Current Release](https://img.shields.io/github/release/sagalbot/vue-select.svg?style=flat-square)

> Everything you wish the native `<select>` element could do, wrapped 
up into a zero dependency, highly extensible Vue component. 

Vue Select is a feature rich select/dropdown/typeahead component. It provides a default
template that fits the 80% use case for a select dropdown. Here it is by default:

<div style="max-width:50%; margin: 0 auto; padding: 1rem 0;">
  <v-select :options="['Option One','Option Two','Option Three']" />
</div> 

#### Features
- AJAX Support
- Tagging
- List Filtering/Searching
- Supports Vuex
- Select Single/Multiple Options
- Tested with Bootstrap 3/4, Bulma, Foundation
- +95% Test Coverage
- ~33kb minified with CSS
- Zero dependencies

#### Resources
- **[CodePen Template](http://codepen.io/sagalbot/pen/NpwrQO)**
- **[Trello Roadmap](https://trello.com/b/vWvITNzS/vue-select)**
- **[GitHub](https://github.com/sagalbot/vue-select)**