Awesome
vue-dialog-drag
Simple draggable dialog
Features:
- Drag & Drop
- Touch support (only for drag, not for drop)
- Drop area component
- 'Pin mode', to lock drag.
Installation
npm install vue-dialog-drag --save
Usage
Import and register component
import DialogDrag from 'vue-dialog-drag'
export default{
...
components:{
DialogDrag
}
}
include css
<style src='vue-dialog-drag/dist/vue-dialog-drag.css'></style>
Or import source component from: 'vue-dialog-drag/src/vue-dialog-drag.vue' And install devDependencies. (stylus and pug) see package.json)
Examples
Single file component
<template>
<div id="app">
<dialog-drag id="dialog-1">
<p> Test dialog</p>
</dialog-drag>
<drop-area @drop='drop'>
<p>Drop Here</p>
</drop-area>
</div>
</template>
<script>
import DialogDrag from 'vue-dialog-drag'
import DropArea from 'vue-dialog-drag/dist/drop-area'
export default {
name: 'app',
components: {
DialogDrag,
DropArea
},
methods: {
drop (id) {
console.log('drop id:', id)
}
}
}
</script>
<style src="vue-dialog-drag/dist/vue-dialog-drag.css"></style>
<style src="vue-dialog-drag/dist/drop-area.css"></style>
<!-- optional dialog styles, see example -->
<style src="vue-dialog-drag/dist/dialog-styles.css"></style>
html
Dialog Component
Slots
- title: dialog title. If you don't need formatted title, use 'title' prop.
- button-pin: content for pin button
- button-pinned: content for pin button when dialog is pinned
- button-close: content for close button
Props
- id: Unique id for dialog
- title: Dialog title
- eventCb: Function(props Object)
- options: Object
- left: Number
- top: Number
- zIndex: Number
- x: alias of left
- y: alias of top
- z: alias of zIndex
- width: Number (0 or null to auto)
- height: Number (0 or null to auto)
- buttonPin: Boolean
- buttonClose:Boolean
- dragCursor: css cursor to show when drag is enabled
- centered: "viewport" | "parent" , center dialog to viewport or parent element
- pinned: Boolean, disable/enable drag
- dropEnabled: Boolean, handle drag with mouse events, instead of drag events
Events
All event emits an object: { id, left, top, x, y, z, width, height, pinned } You can format it, whith 'eventCb' prop.
- load: fired on mounted
- focus: fired on click and touch
- pin: fired on pin / unpin dialog
- drag-start: fired on dragstart
- move: fired when move dialog
- drag-end: fired on dragend
- close: fired when close dialogs
Css
The main container has class .dialog-drag, and .dialog-drag .fixed when dialog is pinned
You can import extra dialog styles from dist/dialog-styles.css.
view: example styles
Drop area component
Slots
Over: content rendered when the dialog is dragged over drop area.
Events
drop: fired when drop the dialog, emits dialog id.