vue-select/docs/README.md

<SponsorBanner />

# Vue Select

![Current Release](https://img.shields.io/github/release/sagalbot/vue-select.svg?style=flat-square)
![Release Date](https://img.shields.io/github/release-date/sagalbot/vue-select?style=flat-square)
![Bundle Size](https://flat.badgen.net/bundlephobia/min/vue-select)
![Monthly Downloads](https://img.shields.io/npm/dm/vue-select.svg?style=flat-square)
![Coverage Status](https://coveralls.io/repos/github/sagalbot/vue-select/badge.svg?branch=master)
![MIT License](https://img.shields.io/github/license/sagalbot/vue-select.svg?style=flat-square)

> Everything you wish the HTML `<select>` element could do, wrapped
> up into a lightweight, extensible Vue component.

Vue Select is a feature rich select/dropdown/typeahead component. It provides a default
template that fits most use cases for a filterable select dropdown. The component is designed to be as
lightweight as possible, while maintaining high standards for accessibility,
developer experience, and customization.

<div style="max-width:25rem; margin: 0 auto; padding: 1rem 0;">
  <country-select />  
</div>

Vue Select aims to be as lightweight as possible, while maintaining high standards for accessibility,
developer experience, and customization. Huge thanks to the [sponsors](sponsors.md) and
[contributors](contributors.md) that make Vue Select possible!

## Features

- Tagging
- Filtering / Searching
- Vuex Support
- AJAX Support
- SSR Support
- Accessible
- ~20kb Total / ~5kb CSS / ~15kb JS
- Select Single/Multiple Options
- Customizable with slots and SCSS variables
- Zero dependencies

## Resources

- **[GitHub](https://github.com/sagalbot/vue-select)**
- **[CodePen Template](http://codepen.io/sagalbot/pen/NpwrQO)**