服务器之家:专注于服务器技术及软件下载分享
分类导航

node.js|vue.js|jquery|angularjs|React|json|js教程|

服务器之家 - 编程语言 - JavaScript - vue.js - 如何使用vue自定义指令构建拖放插件

如何使用vue自定义指令构建拖放插件

2022-03-07 15:52指尖上的代码go vue.js

这篇文章主要介绍了如何使用vue自定义指令构建拖放插件,帮助大家更好的理解和学习使用vue,感兴趣的朋友可以了解下

我们都知道html5的拖放特性,利用它可以很方便的实现拖拽和放置功能,比如一些选择类操作的使用场景,让用户去拖拽比鼠标点击更容易接受和理解。今天我们就利用这一特性,结合vue的自定义指令,来实现一个简单但是实用的拖放插件。

为什么叫它插件?因为我们的目标不是开发一个vue组件,而是两个vue的自定义指令,并且最终会把这两个自定义指令封装到一个es6的class里,在实际项目中引入就可以很方便的使用了。

大部分的拖放使用场景都是把一些待选元素从A区域拖放到B区域。这里就涉及到两个概念,一个是可拖拽,一个是可放置,待选元素一定是可以被拖拽的,而目标区域(容器)一定是可以放置的。

如果我们开发一个可拖拽的vue组件,或者开发一个可放置的组件,那仅仅是这个组件可拖放,此时如果需求变更,又需要另外一个组件也支持拖放,那我们仍需要为另一个组件也编写拖放的代码。又或者其他项目也需要拖放功能了,我们也要重新开发。这样非常不利于维护和复用,而vue的自定义指令很好的帮我们解决了这个问题,我们只需要在组件(包括普通的dom元素)上添加自定义指令,就可以使这个组件(元素)可拖放,这样就可以灵活的去使用了。

除了核心功能默认内置的指令 (v-model 和 v-show),Vue 也允许注册自定义指令。注意,在 Vue2.0 中,代码复用和抽象的主要形式是组件。然而,有的情况下,你仍然需要对普通 DOM 元素进行底层操作,这时候就会用到自定义指令。

综上,本文的目标需要完成两个自定义指令:

  • v-drag 使组件可拖拽
  • v-drop 使组件可放置

目标已经很明确了,那就开始动手吧!由于我们要让这两个指令可在任意组件上发挥作用,因此需要注册Vue全局指令。

?
1
2
3
4
5
6
7
8
9
10
11
Vue.directive('drag', {
   bind(el, binding, vnode){
        //只调用一次,指令第一次绑定到元素时调用。
        //在这里可以进行一次性的初始化设置。
    }
})
Vue.directive('drop', {
   bind(el, binding, vnode){
        //
    }
})

如果你的项目是vue-cli搭建的,你可以把这段代码写在main.js里vue初始化的上方。

我们先在drag指令的bind钩子里编写代码,bind只调用一次,并且是在指令第一次绑定到元素时调用,因此我们用了bind钩子。这个指令的目标是让组件(元素)可拖拽,所以我们设置el的draggable为true

?
1
2
3
4
el.draggable = true;
el.ondragstart = (event)=>{
  event.dataTransfer.setData("Text", "your data...");
}

当元素被拖拽时,会先触发ondragstart事件,通常我们都会在这个事件里为event的dataTransfer设置拖拽数据,目的是当元素被放置时,目标容器可以获取拖拽过来的数据,如果拖放不能传递数据,那将是没有意义的。上面的代码调用dataTransfer的setData方法设置拖拽数据,setData的参数1表示数据类型,参数2表示要传递的数据。

很不幸,拖拽数据目前仅支持字符串,如果你想传递复杂对象,可以将数据序列化

接下来我们为drop指令的bind钩子编写代码,这个指令的目的是让组件(元素)可放置,因此我们需要为元素的ondragover(拖拽经过事件)、ondrop(放置事件)编写handler,这两个handler要阻止事件的默认行为。

?
1
2
3
4
5
6
7
el.ondragover = (event)=>{
  event.preventDefault(); //阻止默认行为
}
el.ondrop = (event)=>{
  event.preventDefault();
  let dragData = event.dataTransfer.getData('Text'); //获取拖拽数据
}

我们通过event.dataTransfer的getData方法可以获取到拖拽开始事件中设置的拖拽数据。

现在你就可以把这两个指令加到任何组件上了,加了v-drag的组件可以被拖动,加了v-drop的组件可以放置并接收拖拽数据。

?
1
2
3
<MyComponent v-drag></MyComponent>
 
<MyContainer v-drop></MyContainer>

新的问题来了,我们进行拖拽操作是为了传递数据,然而传递数据的开始阶段,我们是在自定义指令drag的bind钩子里进行的,传递数据的接收阶段,我们是在drop的bind钩子里进行的,那么,数据从哪儿来?到哪儿去?很显然,数据应该来自组件,也应该传递给另一个组件,否则我们把指令写到vue组件上就没有任何意义了。

好在自定义指令的钩子函数为我们提供了访问组件最简单有效的方式:那就是钩子函数的第三个参数vnode,vnode有一个属性是componentInstance,这个componentInstance就是自定义指令的宿主:vue组件实例!

接下来就很容易了,我们只需要为添加了v-drag的组件定义一个获取拖拽数据的接口,为添加了v-drop的组件定义一个接收拖拽数据的接口即可。虽然vue组件并不支持接口的定义,但我们可以约定好这两个方法名,在组件的method中进行实现即可。

?
1
2
3
4
5
6
7
8
9
//自定义组件内部
methods:{
  getDragData(){ //约定getDragData为获取组件拖拽数据的接口方法
    return this.id; //假设这个组件被拖拽时,需要将id传递出去
  }
  setDragData(data){ //约定setDragData为组件接收拖拽数据的接口方法
    this.appendNewChildById(data); //假设这个组件接收id来生成新元素
  }
}

然后改写我们自定义指令设置和传递拖拽数据的代码:

?
1
2
3
4
5
let dragValue = "";
if(vnode.componentInstance.getDragData != undefined){
  dragValue = vnode.componentInstance.getDragData();
}
event.dataTransfer.setData("Text", dragValue);

v-drop指令中的ondrop事件

?
1
2
3
4
let dragValue = event.dataTransfer.getData('Text');
if(vnode.componentInstance.setDragData != undefined){
  vnode.componentInstance.setDragData(dragValue);
}

我们在访问组件的接口方法时加了 if 判断,因为没有接口的约束,组件可能并没有实现这些方法。

好啦,到这里我们已经完全实现了组件拖放的自定义指令,虽然很简单,但是很实用也很灵活,基本可以满足日常拖拽的需求,让我们总结一下整个流程吧!

  • 自定义全局指令 v-drag、v-drop
  • 需要拖拽的组件实现获取数据的接口方法
  • 需要放置的组件实现接收数据的接口方法
  • drag指令访问组件的接口方法获取数据
  • drop指令访问组件的接口方法传递数据

我们将全局自定义指令的相关代码封装到一个es6的class里面,并作为一个单独的js文件放到项目里,或者发布到npm上,然后在main.js里导入这个类,调用静态初始化方法,即可完成全局指令的注册。这样一来,项目当中的任意组件都可以使用v-drag和v-drop了,上面总结的五个步骤,只需要实现第2、3条即可。

以上就是如何使用vue自定义指令构建拖放插件的详细内容,更多关于vue自定义指令构建拖放插件的资料请关注服务器之家其它相关文章!

原文链接:https://www.cnblogs.com/cqqfboy/p/14667016.html

延伸 · 阅读

精彩推荐
  • vue.jsVue中引入svg图标的两种方式

    Vue中引入svg图标的两种方式

    这篇文章主要给大家介绍了关于Vue中引入svg图标的两种方式,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的...

    十里不故梦10222021-12-31
  • vue.js梳理一下vue中的生命周期

    梳理一下vue中的生命周期

    看过很多人讲vue的生命周期,但总是被绕的云里雾里,尤其是自学的同学,可能js的基础也不是太牢固,听起来更是吃力,那我就已个人之浅见,以大白话...

    CRMEB技术团队7992021-12-22
  • vue.jsVue多选列表组件深入详解

    Vue多选列表组件深入详解

    这篇文章主要介绍了Vue多选列表组件深入详解,这个是vue的基本组件,有需要的同学可以研究下...

    yukiwu6752022-01-25
  • vue.jsVue项目中实现带参跳转功能

    Vue项目中实现带参跳转功能

    最近做了一个手机端系统,其中遇到了父页面需要携带参数跳转至子页面的问题,现已解决,下面分享一下实现过程,感兴趣的朋友一起看看吧...

    YiluRen丶4302022-03-03
  • vue.js详解vue 表单绑定与组件

    详解vue 表单绑定与组件

    这篇文章主要介绍了vue 表单绑定与组件的相关资料,帮助大家更好的理解和学习使用vue框架,感兴趣的朋友可以了解下...

    Latteitcjz6432022-02-12
  • vue.jsVue2.x 项目性能优化之代码优化的实现

    Vue2.x 项目性能优化之代码优化的实现

    这篇文章主要介绍了Vue2.x 项目性能优化之代码优化的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋...

    优小U9632022-02-21
  • vue.js用vite搭建vue3应用的实现方法

    用vite搭建vue3应用的实现方法

    这篇文章主要介绍了用vite搭建vue3应用的实现方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下...

    Asiter7912022-01-22
  • vue.jsVue2.x-使用防抖以及节流的示例

    Vue2.x-使用防抖以及节流的示例

    这篇文章主要介绍了Vue2.x-使用防抖以及节流的示例,帮助大家更好的理解和学习使用vue框架,感兴趣的朋友可以了解下...

    Kyara6372022-01-25