drag-select-vue
v1.8.0
Published
Simple Vue library that enables drag to select functionality. P.S. It works with touchscreens too!
Downloads
529
Maintainers
Readme
drag-select-vue
Simple Vue library that enables drag to select functionality. P.S. It works with touchscreens too!
Live demo here
Run the demo locally by cloning this and doing
npm install
npm run serve
Installation
npm install drag-select-vue
Usage
Import the component and register it in your own component.
import DragSelect from "drag-select-vue";
export default {
components: { DragSelect },
...
}
Drag select uses an attribute prop to identify the children that it can select. Make sure to pass the custom name to the frag-select component and also that the children inside have the attribute set with an unique identifier for each one.
For example, these divs have the "customAttribute" set on them with the values 1, 2, and 3
<drag-select attribute="customAttribute">
<div v-for="item in [1,2,3]" :customAttribute="item" />
</drag-select>
Drag select will give you back a list of the custom attribute values that were selected.
There are 2 ways in which you can get access to the selected values.
1. Scoped slot prop
Use this method if you don't need access to the list from outside the component, for example if you just want to set some styling on the selected children.
Selected is a list of strings because html attributes are stored as strings no matter the original type.
That is why the includes method needs a string conversion to be correct even though the original item set on the attribute is a number
<drag-select attribute="attr">
<template v-slot="{ selected }">
<div v-for="item in [1,2,3]"
:attr="item"
:class="{'item-selected-class': selected.includes(String(item))}"/>
</template>
</drag-select>
2. Change event emitted
Use this when you need access to the list of selected items outside of the drag select component
<div>
<drag-select attribute="attr" @change="selected = $event">
<div v-for="item in [1,2,3]"
:attr="item"
:class="{'item-selected-class': selected.includes(String(item))}"/>
</drag-select>
</div>
export default {
components: { DragSelect },
data() {
return {
//Now you can use this anywhere in your template or js code
selected: []
}
}
}