Everything you wish the HTML <select> element could do, wrapped up into a lightweight, extensible Vue component.
> **Everything you wish the HTML element could do, wrapped up into a lightweight, zero
> dependency, 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.
- 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
Complete documentation and examples available at https://vue-select.org.
- API Documentation
- Vue 2 CodePen Template
- Vue 3 CodePen Template
It takes a lot of effort to maintain this project. If it has saved you development time, please consider sponsoring the project
with GitHub sponsors!
Huge thanks to the sponsors and contributors that make Vue Select possible!
Vue 3 / Vue Select 4.x-beta
> Vue 3 support is on the beta channel: vue-select@beta, and will become the new default when v4 is released. See #1579 for more details!
Install:
``bash
yarn add vue-select@beta
npm install vue-select@beta
`
Then, import and register the component:
`jsmain.ts or main.js
import { createApp } from "vue";
import App from "./App.vue";
import { VueSelect } from "vue-select";
createApp(App)
.component("v-select", VueSelect)
.mount("#app");
`
The component itself does not include any CSS. You'll need to include it separately in your Component.vue:
`vue`
Vue 2 / Vue Select 3.x
Install:
`bash
yarn add vue-select
npm install vue-select
`
Then, import and register the component:
`js
import Vue from "vue";
import vSelect from "vue-select";
Vue.component("v-select", vSelect);
`
The component itself does not include any CSS. You'll need to include it separately:
`js``
import "vue-select/dist/vue-select.css";
You can also include vue-select directly in the browser. Check out the
documentation for loading from CDN..