在我们开发过程中,有些处理起来非常麻烦的小功能,用自定义指令可能非常简单就能实现。首先看下vue官网关于自定义指令的介绍:
简介
除了核心功能默认内置的指令 (v-model 和 v-show),Vue 也允许注册自定义指令。注意,在 Vue2.0 中,代码复用和抽象的主要形式是组件。然而,有的情况下,你仍然需要对普通 DOM 元素进行底层操作,这时候就会用到自定义指令。举个聚焦输入框的例子。
当页面加载时,该元素将获得焦点。只要你在打开这个页面后还没点击过任何内容,这个输入框就应当还是处于聚焦状态。现在让我们用指令来实现这个功能:
基础用法
// 注册一个全局自定义指令 `v-focus`
Vue.directive('focus', {
// 当被绑定的元素插入到 DOM 中时……
inserted: function (el) {
// 聚焦元素
el.focus()
}
})
// template
<input v-focus>
除了可以在vue的全局注册全局的自定义指令,vue也支持在组件内注册组建的自定义指令。
钩子函数
一个指令定义对象可以提供如下几个钩子函数 (均为可选):
bind:只调用一次,指令第一次绑定到元素时调用。在这里可以进行一次性的初始化设置。
inserted:被绑定元素插入父节点时调用 (仅保证父节点存在,但不一定已被插入文档中)。
update:所在组件的 VNode 更新时调用,但是可能发生在其子 VNode 更新之前。指令的值可能发生了改变,也可能没有。但是你可以通过比较更新前后的值来忽略不必要的模板更新 (详细的钩子函数参数见下)。
componentUpdated:指令所在组件的 VNode 及其子 VNode 全部更新后调用。
unbind:只调用一次,指令与元素解绑时调用。
钩子函数参数
指令钩子函数会被传入以下参数:
el:指令所绑定的元素,可以用来直接操作 DOM。
binding:一个对象,包含以下 property:
name:指令名,不包括 v- 前缀。
value:指令的绑定值,例如:v-my-directive="1 + 1" 中,绑定值为 2。
oldValue:指令绑定的前一个值,仅在 update 和 componentUpdated 钩子中可用。无论值是否改变都可用。
expression:字符串形式的指令表达式。例如 v-my-directive="1 + 1" 中,表达式为 "1 + 1"。
arg:传给指令的参数,可选。例如 v-my-directive:foo 中,参数为 "foo"。
modifiers:一个包含修饰符的对象。例如:v-my-directive.foo.bar 中,修饰符对象为 { foo: true, bar: true }。
vnode:Vue 编译生成的虚拟节点。移步 VNode API 来了解更多详情。
oldVnode:上一个虚拟节点,仅在 update 和 componentUpdated 钩子中可用。
在项目中的使用
在我们开发后台管理系统过程中,会经常遇到这样的需求,根据这个用户的权限或者类型,来控制某个按钮显不显示,比如审批按钮、下载按钮,实现方式非常多,这个地方就可以用自定义指令来实现。
可以给用户加一个标记,比如userType,也可以根据用户的角色,比如有某个审批角色的用户,也可以根据用户是否有某个菜单权限来控制,这里就以根据用户是否有某个角色来控制
首先创建一个全局的自定义指令:
Vue.directive('has', {
// 当被绑定的元素插入到 DOM 中时……
inserted: function(el, binding) {
var sysRoles = store.state.user.sysRoles
if (!sysRoles) return false
var isHas = sysRoles.some(e => {
return e.id === 1
})
!isHas ? el.style.display = 'none' : el.style.display = 'inline-block'
}
})
当某个角色的id等于1的时候,显示按钮,否则不显示
<el-button v-has="" type="primary" size="small>审批</el-button>
全局都可以使用,一个标签就可以实现业务功能
实用插件
网上有非常多非常实用的自定义指令,这里推荐常用的两款
v-clipboard(点击复制内容到粘贴板功能)
在我们开发后台管理系统的时候,实现点击表格的某一项,复制到粘贴板的功能。
1、安装
npm install --save v-clipboard
2、引用
import Vue from 'vue'
import Clipboard from 'v-clipboard'
Vue.use(Clipboard)
3、table组件中使用
<el-table-column label="姓名" align="center">
<template slot-scope="scope">
<div @click="handleCopy(scope.row.name)">{{ scope.row.name }}</div>
</template>
</el-table-column>
4、mixins中创建一个全局的方法
在全局的mixins里面创建一个方法
var mixins = {
data() {
return {
}
},
methods: {
handleCopy(value) {
this.$clipboard(value)
this.$message.success('已复制到粘贴板')
}
}
}
export default mixins
5、完成
项目是基于自定义指令实现的,有兴趣的可以关注一下项目源码:
https://github.com/euvl/v-clipboard
Vue-Lazyload(图片懒加载)
demo地址:http://hilongjw.github.io/vue-lazyload/
源码地址:https://github.com/hilongjw/vue-lazyload
非常简单实用的图片懒加载工具
1、安装
npm install --save vue-lazyload
2、引用
import loading from './assets/common/loading.gif'
import VueLazyload from 'vue-lazyload'
Vue.use(VueLazyload, {
preload: .8,
loading,
// error,
})
3、使用
<img v-lazy="https://www.domain.com/image.jpg">
可以非常简单的实现图片懒加载
![image.png](https://upload-images.jianshu.io/upload_images/19824658-7c6b4aba4ca35489.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
vue确实有很多非常实用的小技巧能帮助我们提高开发效率,提升用户体验,多看大神的开源代码,对我们找到最合适的解决方案提升会很大。