3.0.6 • Published 14 days ago

@vuesimple/vs-select v3.0.6

Weekly downloads
-
License
MIT
Repository
github
Last release
14 days ago

Vue Simple Select

🗃 A simple vue select. Perfect for all your select scenarios.

A light weight vue plugin built groundup.

npm npm

forthebadge forthebadge forthebadge forthebadge forthebadge forthebadge

📺 Live Demo

Code Sandbox: Link

🛠 Install

npm i @vuesimple/vs-select

🚀 Usage

<template>
  <vs-select :options="options1"></vs-select>
  <vs-multiselect :options="options1"></vs-multiselect>
</template>

<script>
  import { VsSelect, VsMultiselect } from '@vuesimple/vs-select';

  export default {
    components: {
      VsSelect,
      VsMultiselect,
    },

    data() {
      return {
        options1: ['Derek', 'Ryan', 'BB', 'Chris'],
        options2: [
          { label: 'Derek', value: 'D' },
          { label: 'Ryan', value: 'R' },
          { label: 'BB', value: 'BB' },
          { label: 'Chris', value: 'C' },
        ],
      };
    },
  };
</script>

🌎 CDN

<script src="https://unpkg.com/@vuesimple/vs-select@<version>/dist/vs-select.min.js"></script>
// Main/Entry file
app.use(VsSelect.plugin);
<template>
  <vs-select :options="options1"></vs-select>
  <vs-multiselect :options="options1"></vs-multiselect>
</template>

Nuxt Code Snippet

After installation,

  • Create a file /plugins/vs-select.js

    import Vue from 'vue';
    import { VsSelect, VsMultiselect } from '@vuesimple/vs-select';
    
    Vue.component('vs-select', VsSelect);
    Vue.component('vs-multiselect', VsMultiselect);
  • Update nuxt.config.js

    module.exports = {
      ...
      plugins: [
        { src: '~plugins/vs-select', mode: 'client' }
        ...
      ]
    }
  • In the page/ component

    <template>
      <vs-select :options="options1"></vs-select>
      <vs-multiselect :options="options1"></vs-multiselect>
    </template>

⚙ Props

NameTypeDefaultDescription
optionsArray-This can be array or array of objects. ['Tony', 'Bruce'] or [{ label: 'Derek', value: 'D' }],
isSearchBooleanfalseSearchable select
labelString-Label text
placeholderString'Select'Placeholder text
preselectedArray-Preselected items. For array of objects, pass value as array items ex: ['D', 'BB']
disabledBooleanfalseTo disable select box
isErrorBooleanfalseTo show error in select box
isMenuBooleanfalseTo display like menu dropdown. Available only on vs-select
isCompactBooleanfalseApplies compact style to vs-select
emptyItemsTextStringNo Data AvailableEmpty text

Note You can also pass disable: true in array of objects to disable particular item.

// Example
<template>
  <vs-select :options="options"></vs-select>
</template>

<script>
  import { VsSelect } from 'vs-select';

  export default {
    data() {
      return {
        options: [
          { label: 'Iron Man', value: 'Tony' },
          { label: 'Thor', value: 'thor', disabled: true },
          { label: 'Captain America', value: 'Steve Roger' },
        ],
      };
    },
  };
</script>

🔥 Events

NameDescription
v-modelEmitted when the item is selected.
@changeEmitted when the item is selected.(arg1: value, arg2: object/value)

Note Colors/ radius can be modified for the select box using css variables. Default colors used:

<style>
  .vs-select,
  .vs-multiselect {
    --vs-select-bg: #ffffff;
    --vs-select-border: #d8dcde;
    --vs-select-border-hover: #5293c7;
    --vs-select-hover: #edf7ff;
    --vs-select-error: #cc3340;
    --vs-select-icon: #68737d;
    --vs-select-border-radius: 4px;
  }
</style>
3.0.6

14 days ago

3.0.3

7 months ago

3.0.2

7 months ago

3.0.1

7 months ago

3.0.5

7 months ago

3.0.0

7 months ago

1.4.15

8 months ago

1.4.14

8 months ago

1.4.18

8 months ago

1.4.13

1 year ago

1.4.12

1 year ago

1.4.9

2 years ago

1.4.11

2 years ago

1.4.8

2 years ago

1.4.10

2 years ago

1.4.6

2 years ago

1.4.5

2 years ago

1.4.4

2 years ago

1.4.3

2 years ago

1.4.2

2 years ago

1.4.1

2 years ago

1.4.0

3 years ago

1.3.41

3 years ago

1.3.40

3 years ago

1.3.39

3 years ago

1.3.36

3 years ago

1.3.37

3 years ago

1.3.38

3 years ago

1.3.35

3 years ago

1.3.31

3 years ago

1.3.32

3 years ago

1.3.30

3 years ago

1.3.33

3 years ago

1.3.34

3 years ago

1.3.28

3 years ago

1.3.29

3 years ago

1.3.27

3 years ago

1.3.26

3 years ago

1.3.25

3 years ago

1.3.24

3 years ago

1.3.23

3 years ago

1.3.21

3 years ago

1.3.19

3 years ago

1.3.20

3 years ago

1.3.18

3 years ago

1.3.17

3 years ago