Skip to content

Latest commit

 

History

History
403 lines (300 loc) · 7.54 KB

README.md

File metadata and controls

403 lines (300 loc) · 7.54 KB
Raw

logo

VueDraggableResizable

Latest Version on NPM Software License npm

Vue 用于可调整大小和可拖动元素的组件并支持组件之间的冲突检测与组件对齐

Features

  • 没有依赖
  • 可拖动，可调整大小或者两者都行
  • 拥有用于调整大小的控制点
  • 限制组件调整大小和移动超出父元素
  • 自定义网格移动
  • 将拖动限制为垂直或水平移动

新增特征

  • 组件之间的冲突检测（不允许组件之间重叠）
  • 组件与组件之间进行对齐（类似于吸附效果）

Demo

Demo

增加冲突检测与元素对齐

Props

isConflictCheck
Type: Boolean
Required: false
Default: false

定义组件是否开启冲突检测。

<vue-draggable-resizable :is-conflict-check="true">

snap
Type: Boolean
Required: false
Default: false

定义组件是否开启元素对齐。

<vue-draggable-resizable :snap="true">

snapTolerance
Type: Number
Required: false
Default: 5

当调用snap时，定义组件与元素之间的对齐距离，以像素为单位。

<vue-draggable-resizable :snap="true" :snap-tolerance="20">

安装新版本

$ npm install --save vue-draggable-resizable-gorkys

原组件文档翻译

安装和基本用法

$ npm install --save vue-draggable-resizable

注册组件

import Vue from 'vue'
import VueDraggableResizable from 'vue-draggable-resizable'

Vue.component('vue-draggable-resizable', VueDraggableResizable)

现在可以在标记中使用该组件

<template>
  <div style="height: 500px; width: 500px; border: 1px solid red; position: relative;">
    <vue-draggable-resizable :w="100" :h="100" v-on:dragging="onDrag" v-on:resizing="onResize" :parent="true">
      <p>Hello! I'm a flexible component. You can drag me around and you can resize me.<br>
      X: {{ x }} / Y: {{ y }} - Width: {{ width }} / Height: {{ height }}</p>
    </vue-draggable-resizable>
  </div>
</template>

<script>
import VueDraggableResizable from 'vue-draggable-resizable'

export default {
  data: function () {
    return {
      width: 0,
      height: 0,
      x: 0,
      y: 0
    }
  },
  methods: {
    onResize: function (x, y, width, height) {
      this.x = x
      this.y = y
      this.width = width
      this.height = height
    },
    onDrag: function (x, y) {
      this.x = x
      this.y = y
    }
  }
}
</script>

Props

active

Type: Boolean
Required: false
Default: false

确定组件是否应处于活动状态。 prop对更改做出反应，也可以与syncmodifier 一起使用以保持状态与父级同步。

<vue-draggable-resizable :active="true">

draggable

Type: Boolean
Required: false
Default: true

定义组件应该是否可拖动。

<vue-draggable-resizable :draggable="false">

resizable

Type: Boolean
Required: false
Default: true

定义组件是否可以调整大小。

<vue-draggable-resizable :resizable="false">

w

Type: Number
Required: false
Default: 200

定义元素的初始宽度。

<vue-draggable-resizable :w="200">

h

Type: Number
Required: false
Default: 200

定义元素的初始高度。

<vue-draggable-resizable :h="200">

minw

Type: Number
Required: false
Default: 50

定义元素的最小宽度。

<vue-draggable-resizable :minw="50">

minh

Type: Number
Required: false
Default: 50

定义元素的最小高度。

<vue-draggable-resizable :minh="50">

x

Type: Number
Required: false
Default: 0

定义元素的初始x位置。

<vue-draggable-resizable :x="0">

y

Type: Number
Required: false
Default: 0

定义元素的初始y位置。

<vue-draggable-resizable :y="0">

z

Type: Number|String
Required: false
Default: auto

定义元素的zIndex。

<vue-draggable-resizable :z="999">

handles

Type: Array
Required: false
Default: ['tl', 'tm', 'tr', 'mr', 'br', 'bm', 'bl', 'ml']

定义句柄数组以限制元素大小调整：

  • tl - 左上角
  • tm - 中上方
  • tr - 右上角
  • mr - 右中方
  • br - 右下角
  • bm - 下中方
  • bl - 左下方
  • ml - 左中方
<vue-draggable-resizable :handles="['tm','bm','ml','mr']">

axis

Type: String
Required: false
Default: both

定义元素可拖动的轴。可用值为x, y 或者 both.

<vue-draggable-resizable axis="x">

grid

Type: Array
Required: false
Default: [1,1]

定义捕捉元素的网格。

<vue-draggable-resizable :grid="[1,1]">

parent

Type: Boolean
Required: false
Default: false

将元素的移动和尺寸限制为父元素。

<vue-draggable-resizable :parent="true">

dragHandle

Type: String
Required: false

定义应该用于拖动组件的选择器。

<vue-draggable-resizable drag-handle=".drag">

dragCancel

Type: String
Required: false

定义应该用于阻止拖动初始化的选择器。

<vue-draggable-resizable drag-cancel=".drag">

maximize

Type: Boolean
Required: false
Default: false

如果设置为true，则允许组件在双击时填充其父级。

<vue-draggable-resizable :maximize="true">

Events

activated

Required: false
Parameters: -

单击组件时调用，以显示句柄。

<vue-draggable-resizable @activated="onActivated">

deactivated

Required: false
Parameters: -

每当用户单击组件外的任何位置时调用，以便停用它。

<vue-draggable-resizable @deactivated="onDeactivated">

resizing

Required: false
Parameters:

  • left元素的X位置
  • top 元素的Y位置
  • width元素的宽度
  • height 元素的高度

每当组件调整大小时调用。

<vue-draggable-resizable @resizing="onResizing">

resizestop

Required: false
Parameters:

  • left 元素的X位置
  • top 元素的Y位置
  • width 元素的宽度
  • height 元素的高度

每当组件停止调整大小时调用。

<vue-draggable-resizable @resizestop="onResizstop">

dragging

Required: false
Parameters:

  • left 元素的X位置
  • top 元素的Y位置

每当拖动组件时调用。

<vue-draggable-resizable @dragging="onDragging">

dragstop

Required: false
Parameters:

  • left元素的X位置
  • top 元素的Y位置

每当组件停止拖动时调用。

<vue-draggable-resizable @dragstop="onDragstop">

Gotchas

如果要在其父元素中限制组件，请小心使用x，y，w，h，minh和minh props的适当值。

Bonus

如果 resizing, parent 和maximize道具 为true ，您可以双击元素以使其填充父级。