# ui-vue-select

> Vue select plugin

Latest version **0.5.3** (published 2020-03-11) · MIT license · 0 weekly downloads

## Install

```sh
npm install ui-vue-select
pnpm add ui-vue-select
yarn add ui-vue-select
bun add ui-vue-select
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.5.3 |
| Published | 2020-03-11 |
| First published | 2020-02-18 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 33.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | Drew Dru |
| Maintainers | drew.drux |
| Keywords | vue, custom-vue-select |

## Links

- npm: https://www.npmjs.com/package/ui-vue-select
- Repository: https://github.com/drewdru/ui-vue-select
- Homepage: https://github.com/drewdru/ui-vue-select#readme
- Issues: https://github.com/drewdru/ui-vue-select/issues
- npm.io page: https://npm.io/package/ui-vue-select

## Recent versions

- 0.5.3 (latest) — 2020-03-11
- 0.5.2 — 2020-03-11
- 0.5.1 — 2020-03-11
- 0.4.5 — 2020-03-11
- 0.4.4 — 2020-03-11
- 0.4.3 — 2020-03-10
- 0.4.2 — 2020-02-28
- 0.4.1 — 2020-02-28
- 0.3.2 — 2020-02-21
- 0.3.1 — 2020-02-21
- 0.2.8 — 2020-02-19
- 0.2.7 — 2020-02-19
- 0.2.6 — 2020-02-19
- 0.2.5 — 2020-02-19
- 0.2.4 — 2020-02-19
- … 3 more at https://npm.io/package/ui-vue-select/versions

## README

# UiVueSelect

Custom select for Vue.js

## Installation

### 1. Install
```
yarn add ui-vue-select
# or
npm i ui-vue-select --save
```

### 2. Plug-in
```js
import UiVueSelect from 'ui-vue-select'

Vue.use(UiVueSelect)

new Vue({
  // your vue config
  uiVueSelect: UiVueSelect,
})
```

### 3. Use in your components

```vue
<template>
  <ui-vue-select v-model="language" :items="languages" :searchKeys="['title']">
    <template #ui-vue-select-match="props">
      <flag :iso="props.selected.flag"></flag>
      <span>&nbsp;{{props.selected.title}}</span>
    </template>
    <template #ui-vue-select-options="props">
      <flag :iso="props.item.flag"></flag>
      <span>&nbsp;{{props.item.title}}</span>
    </template>
  </ui-vue-select>
</template>

<script>
  export default {
    async data() {
      return {
        languages: [
          {locale: 'en', flag: 'us', title: 'English'},
          {locale: 'ru', flag: 'ru', title: 'Russian'},
        ],
        language: {locale: 'en', flag: 'us', title: 'English'},
      }
    }
    async created() {
      console.log(this.$uiVueSelect);
    },
  };
</script>
```
### 4. Change ui-vue-select-match-open

Search will work with this example:
```vue
    <template #ui-vue-select-match-open="props">
      <span>{{props.selected.flag}}</span>
      <span>&nbsp;{{props.selected.title}}</span>
      <input
        class="ui-vue-select-search"
        v-model="props.searchText"
        ref="selectSearch"
        @input="props.onSearch($event)"
      >
    </template>
```

### 5. Multiple select

```vue
<template>
  <ui-vue-select
    v-model="selectedLanguages"
    :id="`selectedLanguages`"
    :name="`selectedLanguages`"
    :items="languages"
    :searchKeys="['title']"
    :required="false"
    :multiple="true"
    :limit="2"
  >
    <template #ui-vue-select-match="props">
      <span v-for="(item, i) of props.selected" :key="`item-${i}`">
        <span>{{item.flag}}</span>
        <span>&nbsp;{{item.title}}&nbsp;</span>
      </span>
    </template>          

    <template #ui-vue-select-options="props">
      <!-- <flag :iso="props.item.flag"></flag> -->
      <span>{{props.item.flag}}</span>
      <span>&nbsp;{{props.item.title}}</span>
    </template>
  </ui-vue-select>
</template>
<script>
export default {
  data() {
    return {
      languages: [
        {locale: 'en', flag: 'us', title: 'English'},
        {locale: 'ru', flag: 'ru', title: 'Russian'},
        {locale: 'fr', flag: 'fr', title: 'French'},
        {locale: 'sp', flag: 'sp', title: 'Spanish'},
      ],
      selectedLanguages: [{locale: 'en', flag: 'us', title: 'English'}],
    };
  }
};
</script>

```


## License
MIT

---
_Source: https://npm.io/package/ui-vue-select · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
