拖拽 KLDraggable

基本形式

拖拽 KLDraggable - 图1

  1. <kl-draggable><kl-button type="primary" title="拖我"></kl-button></kl-draggable>

移动自身

拖拽 KLDraggable - 图2

  1. <kl-draggable proxy="self"><kl-button type="primary" title="自由"></kl-button></kl-draggable>
    <kl-draggable proxy="self" direction="horizontal"><kl-button type="secondary" title="水平"></kl-button></kl-draggable>
    <kl-draggable proxy="self" direction="vertical"><kl-button title="垂直"></kl-button></kl-draggable>

修改代理

拖拽 KLDraggable - 图3

  1. <kl-draggable>
    <kl-button type="primary" title="拖我"></kl-button>
    <kl-draggable-proxy>
    <kl-button type="secondary" title="拖我"></kl-button>
    </kl-draggable-proxy>
    </kl-draggable>

API

KLDraggable

KLDraggable

ParamTypeDefaultDescription
[options.data]object= 绑定属性
[options.data.data]object=> 拖拽时需要传递的数据
[options.data.proxy]string/Dragable.Proxy/Element/function@=> 拖拽代理,即拖拽时显示的元素。默认值为clone,拖拽时拖起自身的一个拷贝;当值为self,拖拽时直接拖起自身。也可以用<draggable.proxy>自定义代理,或直接传入一个元素或函数。其他值表示不使用拖拽代理。
[options.data.direction]string"all"=> 拖拽代理可以移动的方向,all为任意方向,horizontal为水平方向,vertical为垂直方向
[options.data.disabled]booleanfalse=> 是否禁用
[options.data.class]string"z-draggable"=> 可拖拽时(即disabled=false)给元素附加此class
[options.data.dragClass]string"z-drag"=> 拖拽该元素时给元素附加此class

dragstart 拖拽开始时触发Event

NameTypeDescription
senderobject事件发送对象,为当前draggable
originobject拖拽源,为当前draggable
sourceobject拖拽起始元素
proxyobject拖拽代理元素
dataobject拖拽时需要传递的数据
screenXnumber鼠标指针相对于屏幕的水平位置
screenYnumber鼠标指针相对于屏幕的垂直位置
clientXnumber鼠标指针相对于浏览器的水平位置
clientYnumber鼠标指针相对于浏览器的垂直位置
pageXnumber鼠标指针相对于页面的水平位置
pageYnumber鼠标指针相对于页面的垂直位置
movementXnumber鼠标指针水平位置相对于上次操作的偏移量
movementYnumber鼠标指针垂直位置相对于上次操作的偏移量
cancelfunction取消拖拽操作

drag 正在拖拽时触发Event

NameTypeDescription
senderobject事件发送对象,为当前draggable
originobject拖拽源,为当前draggable
sourceobject拖拽起始元素
proxyobject拖拽代理元素
dataobject拖拽时需要传递的数据
screenXnumber鼠标指针相对于屏幕的水平位置
screenYnumber鼠标指针相对于屏幕的垂直位置
clientXnumber鼠标指针相对于浏览器的水平位置
clientYnumber鼠标指针相对于浏览器的垂直位置
pageXnumber鼠标指针相对于页面的水平位置
pageYnumber鼠标指针相对于页面的垂直位置
movementXnumber鼠标指针水平位置相对于上次操作的偏移量
movementYnumber鼠标指针垂直位置相对于上次操作的偏移量
cancelfunction取消拖拽操作

dragend 拖拽结束时触发Event

NameTypeDescription
senderobject事件发送对象,为当前draggable
originobject拖拽源,为当前draggable
sourceobject拖拽起始元素
proxyobject拖拽代理元素