Skip to content

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

License

Notifications You must be signed in to change notification settings

Rabbitzzc/vue-select

Repository files navigation

vue-select Build Status Code Coverage No Dependencies MIT License Current Release

A native Vue.js select component that provides similar functionality to Select2 without the overhead of jQuery.

Features

  • AJAX Support
  • Tagging
  • List Filtering/Searching
  • Supports Vuex
  • Select Single/Multiple Options
  • Bootstrap Friendly Markup
  • +95% Test Coverage
  • ~32kb minified

Documentation

Install & Basic Usage

Vue Compatibility
  • vue ~2.0 use vue-select ~2.0
  • vue ~1.0 use vue-select ~1.0

NPM

Install the package. You should install vue-select@1.3.3 for use with vue ~1.0.

$ npm install vue-select

Register the component

import Vue from 'vue'
import vSelect from 'vue-select'
Vue.component(vSelect)

You may now use the component in your markup

<v-select v-model="selected" :options="['foo','bar']"></v-select>

CDN

Just include vue & vue-select.js - I recommend using unpkg.

<script scr="https://unpkg.com/vue@latest"></script>
<!-- use the latest release -->
<script src="https://unpkg.com/vue-select@latest"></script>
<!-- or point to a specific release -->
<script src="https://unpkg.com/vue-select@1.3.3"></script>

Then register the component in your javascript:

Vue.component('v-select', VueSelect.VueSelect);

You may now use the component in your markup

<v-select v-model="selected" :options="['foo','bar']"></v-select>

Here's an example on JSBin.

For more information, please visit the vue-select documentation.

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 57.1%
  • Vue 32.4%
  • CSS 9.9%
  • HTML 0.6%