@myena/advanced-select
Vue Advanced Select control used in ENA projects
2,029
15
| Install | |
|---|---|
npm install @myena/advanced-select@2.0.0 |
|
| Latest Version: | 2.0.0 |
| Vue: | 2 · 3 |
| License: | MIT |
| Last Updated: | Mar 8, 2023 |
| Links: | GitHub · npm |
Maintainer: andyghiuta
advanced-select
What's this
Component to render a "select" with advanced interactions (search, select/deselect all, etc) for websites built with Vue and Bootstrap 3
Install
npm install @myena/advanced-select
Dependencies
- Vue 2*/3
- *For Vue 2 it depends on
@vue/composition-api, via vue-demi
- *For Vue 2 it depends on
- Bootstrap 3
Demo
https://myena-advanced-select.netlify.app/
Usage
Options can be passed as props
<AdvancedSelect
v-model="value"
:options="options"
:disabled="disabled"
/>
Or as the default slot
<AdvancedSelect
v-model="secondValue"
:disabled="disabled"
>
<option value="1">Text</option>
<option value="2">Text 2</option>
</AdvancedSelect>
import AdvancedSelect from 'advanced-select';
export default {
components: {
AdvancedSelect,
},
data: () => ({
options: [
{ value: 1, text: 'One' },
{ value: 2, text: 'Two' },
],
value: null,
secondValue: '1',
disabled: false,
}),
};
Props
| Prop | Type | Default | Description |
|---|---|---|---|
v-model |
any | null |
Pass v-model to the component to have the reference to the current selected value |
:options |
Array | [] |
The options to display. A list of objects in the form: { value: 1, text: 'One' } or { label: 'Group 1', options: [ { value: 1, text: 'One' } ]. If not passed as prop, it tries to read them from the component default slot, where they can be specified as HTML standard `option |
:search |
Boolean | false |
Show or not a search field to filter the options |
:multiple |
Boolean | false |
Single or multiple select |
:controls |
Boolean | false |
Show or not a couple control buttons at the top for (de)selecting all items |
:collapseHeaders |
Boolean | false |
Show or not a link on the headers to toggle items under them |
:displayMax |
Number | 0 |
How many selected items to display on the button in multiple mode. 0 means all |
:displayText |
String | "{0} items selected" |
Text to display if displayMax is reached. "{0}" will be replaced by the total number |
:dropdownClass |
String | '' |
Class to use for the dropdown menu. EG: 'dropdown-menu-right' |
:texts |
Object | { placeholder: 'Nothing selected', empty: 'No results', selectAll: 'Select all', selectNone: 'Select none', } |
Texts used |
All other DOM attributes are inherited by the component button. For example: :disabled="true" will disable the button.
Related Packages
Version History
| Version | Released | Vue | License |
|---|---|---|---|
| 2.0.0 | ^2.6.11 || | MIT | |
| 1.0.3 | ^2.6.11 || | MIT | |
| 1.0.2 | ^2.6.11 || | MIT | |
| 1.0.1 | ^2.6.11 || | MIT | |
| 1.0.0 | ^2.6.11 || | MIT | |
| 0.9.3 | ^2.5.17 | MIT | |
| 0.9.2 | ^2.5.17 | MIT | |
| 0.9.1 | ^2.5.17 | MIT | |
| 0.9.0 | ^2.5.17 | MIT | |
| 0.8.9 | ^2.5.17 | MIT | |
| 0.8.8 | ^2.5.17 | MIT | |
| 0.8.7 | ^2.5.17 | MIT | |
| 0.8.6 | ^2.5.17 | MIT | |
| 0.8.5 | ^2.5.17 | MIT | |
| 0.8.4 | ^2.5.17 | MIT | |
| 0.8.3 | ^2.5.17 | MIT | |
| 0.8.2 | ^2.5.17 | MIT | |
| 0.8.1 | ^2.5.17 | MIT | |
| 0.8.0 | ^2.5.17 | MIT | |
| 0.7.6 | ^2.5.17 | MIT | |
| 0.7.5 | ^2.5.17 | MIT | |
| 0.7.4 | ^2.5.17 | MIT | |
| 0.7.3 | ^2.5.17 | MIT | |
| 0.7.2 | ^2.5.17 | MIT | |
| 0.7.1 | ^2.5.17 | MIT | |
| 0.6.2 | ^2.5.17 | MIT | |
| 0.6.1 | ^2.5.17 | MIT | |
| 0.6.0 | ^2.5.17 | MIT | |
| 0.5.4 | ^2.5.17 | MIT | |
| 0.5.3 | ^2.5.17 | MIT |
Showing the latest 30 of 39. See every release on npm
Pre-releases (3)
| Version | Released | Vue | License |
|---|---|---|---|
| 1.0.0-alpha.2 | ^3.0.0 | MIT | |
| 1.0.0-alpha.1 | ^3.0.0 | MIT | |
| 1.0.0-alpha.0 | ^3.0.0-beta.1 | MIT |