准备:自定义指令介绍
除了核心功能默认内置的指令 (v-model
和 v-show
等),Vue 也允许注册自定义指令。注意,在 Vue2.0 中,代码复用和抽象的主要形式是组件。然而,有的情况下,你仍然需要对普通 DOM 元素进行底层操作,这时候就会用到自定义指令。
———Vue 官网
作为使用Vue
的开发者,我们对Vue
指令一定不陌生,诸如v-model
、v-on
、v-for
、v-if
等,同时 Vue 也为开发者提供了自定义指令的 api,熟练的使用自定义指令可以极大的提高了我们编写代码的效率,让我们可以节省时间开心的摸鱼~
对于 Vue 的自定义指令相信很多同学已经有所了解,自定义指令的具体写法这里就不细讲了,官方文档很详细。 但是不知道各位同学有没有这种感觉,就是这个技术感觉很方便,也不难,我也感觉学会了,就是不知道如何去应用。这篇文档就是为了解决一些同学的这些问题才写出来的。
PS:这次要讲的自定义指令我们主要使用的是vue2.x
的写法,不过vue3.x
不过是几个钩子函数有所改变,只要理解每个钩子函数的含义,两者的用法差别并不大。
试炼:实现 v-mymodel
我的上篇文章说到要自己实现一个v-model
指令,这里使用v-myodel
模拟一个简易版的,顺便再领不熟悉的同学熟悉一下自定义指令的步骤和注意事项。
定义指令
首先梳理思路:原生input
控件与组件的实现方式需要区分,input
的实现较为简单,我们先实现一下input
的处理。首先我们先定义一个不做任何操作的指令
Vue.directive('mymodel', {
//只调用一次,指令第一次绑定到元素时调用。在这里可以进行一次性的初始化设置。
bind(el, binding, vnode, oldVnode) {
},
//被绑定元素插入父节点时调用 (仅保证父节点存在,但不一定已被插入文档中),需要父节点dom时使用这个钩子
inserted(el, binding, vnode, oldVnode) {
},
//所在组件的 VNode 更新时调用,**但是可能发生在其子 VNode 更新之前**。指令的值可能发生了改变,也可能没有。但是你可以通过比较更新前后的值来忽略不必要的模板更新 (详细的钩子函数参数见下)。
update(el, binding, vnode, oldVnode) {
},
//指令所在组件的 VNode **及其子 VNode** 全部更新后调用。
componentUpdated(el, binding, vnode, oldVnode) {
},
只调用一次,指令与元素解绑时调用。
unbind(el, binding, vnode, oldVnode) {
},
})
复制代码
上面的注释中详细的说明了各个钩子函数的调用时机,因为我们是给组件上添加input
事件和value
绑定,因此我们在bind
这个钩子函数中定义即可。所以我们把其他的先去掉,代码变成这样。
Vue.directive('mymodel', {
//只调用一次,指令第一次绑定到元素时调用。在这里可以进行一次性的初始化设置。
bind(el, binding, vnode, oldVnode) {
}
})
复制代码
简单说一下bind
函数的几个回调参数,el
是指令绑定组件对应的dom
,binding
是我们的指令本身,包含name
、value
、expression
、arg
等,vnode
就是当前绑定组件对应的vnode
结点,oldVnode
就是vnode
更新前的状态。
接下来我们要做两件事:
这对于input
原生组件比较容易实现:
//第一步,添加inout事件监听
el.addEventListener('input', (e) => {
//context是input所在的父组件,这一步是同步数据
vnode.context[binding.expression] = e.target.value;
})
//监听绑定的变量
vnode.context.$watch(binding.expression, (v) => {
el.value = v;
})
复制代码
这里解释一下上面的代码,vnode.context
是什么呢,他就是我们指令所在组件的上下文环境,可以理解就是指令绑定的值所在的组件实例。不熟悉vnode
结构的同学建议先看一下官方的文档,不过文档描述的比较简单,不是很全面,所以最好在控制台log
一下vnode
的对象看一下它具体的结构,这很有助于我们封装自定义指令,对理解Vue
原理也很有帮助。
我们可以通过context[binding.expression]
获取 v-model 上到绑定的值,同样可以修改它。上面的代码中我们首先通过在添加的 input 事件中操作vnode.context[binding.expression] = e.target.value
同步input
的value
值到外部(context
),与使用@input
添加事件监听效果是一样的;然后我们需要做第二件事,做value
值的绑定,监听value
的变化,同步值的变更到input
的value
上,我们想到我们可以使用 Vue 实例上的额$watch
方法监听值的变化,而context
就是那个Vue
实例,binding.expression
就是我们想要监听的属性,如果我们这样写
<input v-mymodel='message'/>
复制代码
那么binding.expression
就是字符串'message'
。所以我们想下面的代码这样监听绑定的响应式数据。
//监听绑定的变量
vnode.context.$watch(binding.expression, (v) => {
el.value = v;
})
复制代码
至此,input
的v-mymodel
的处理就完成了(当然input
组件还有type
为checkbox
,radio
,select
等类型都需要去特别处理,这里就不再一一处理了,感兴趣的同学可以自己尝试去完善一下),但是对于非原生控件的组件,我们要特殊处理。因此我们完善代码如下:
Vue.directive('mymodel', {
//只调用一次,指令第一次绑定到元素时调用。在这里可以进行一次性的初始化设置。
bind(el, binding, vnode, oldVnode) {
//原生input组件的处理
if(vnode.tag==='input'){
//第一步,添加inout事件监听
el.addEventListener('input', (e) => {
//context是input所在的父组件,这一步是同步数据
vnode.context[binding.expression] = e.target.value;
})
//监听绑定的变量
vnode.context.$watch(binding.expression, (v) => {
el.value = v;
})
}else{//组件
}
}
})
复制代码
接下来我们要处理的是自定义组件的逻辑,
//vnode的结构可以参见文档。不过我觉得最直观的方法就是直接在控制台打印处理
let {
componentInstance,
componentOptions,
context
} = vnode;
const {
_props
} = componentInstance;
//处理model选项
if (!componentOptions.Ctor.extendOptions.model) {
componentOptions.Ctor.extendOptions.model = {
value: 'value',
event: 'input'
}
}
let modelValue = componentOptions.Ctor.extendOptions.model.value;
let modelEvent = componentOptions.Ctor.extendOptions.model.event;
//属性绑定,这里直接修改了属性,没有想到更好的办法,友好的意见希望可以提出
_props[modelValue] = binding.value;
context.$watch(binding.expression, (v) => {
_props[modelValue] = v;
})
//添加事件处理函数,做数据同步
componentInstance.$on(modelEvent, (v) => {
context[binding.expression] = v;
})
复制代码
声明一下,上面的实现不是vue
源码的实现方式,vue
源码中实现v-model
更加复杂一点,是结合自定义指令、模板编译等去实现的,因为我们是应用级别的封装,所以采用了上述的方式实现。
实现此v-mymodel
需要同学去多了解一下Vnode
和Component
的API
,就像之前说的,最简单的方法就是直接在控制台中直接打印出vnode
对象,组件的vnode
上有Component
的实例componentInstance
。
接下来简单说一下上面的代码,首先我们可以在componentOptions.Ctor.extendOptions
上找到model
的定义,如果没有的话需要设置默认值value
和input
,然后分别对想原生input
的处理一样,分别监听binding.expression
的变化和modelEvent
事件即可。
需要注意的是,我们上面的代码直接给_prop
做了赋值操作,这实际上是不符合规范的,但是我目前没有找到更好的方法去实现,有好思路的同学可以在评论区留言指教。
下面👇是完整的源码:
应用实践:4 个实用的自定义指令
上文我们通过封装v-mymodel
为各位同学展示了如何封装和使用自定义指令,接下来我把自己在生产实践中使用自定义指令的一些经验分享给大家,通过实例,我相信各位同学能够更深刻的理解如何在在应用中封装自己的指令,提高效率。
权限控制
下面我们定义一个v-permission
指令用于全平台的权限控制
示例代码
//定义权限类型
const permissionType = {
ROLE: 'role',
CURRENTUSER:'currentUser',
BUSSINESSSTATUS: 'bussinessStatus',
MIX_EVERY: 'every',
MIX_SOME: 'some'
}
export default {
//只调用一次,指令第一次绑定到元素时调用
bind: function () {
},
//当前vdom插入到真实dom时,因为是对dom的样式操作,在这里操作
inserted: function (el, binding) {
let show = false;
show=processingType(binding.arg,binding.value);
el.style.display = `${show ? 'inline-block' : 'none'}`
},
//所在组件的VNode更新时调用,状态更新后需要更新显示状态
update: function (el, binding) {
//避免无效的模板更新
if(binding.value===binding.oldValue) return;
let show = false;
show=processingType(binding.arg,binding.value);
el.style.display = `${show ? 'inline-block' : 'none'}`
},
//指令所在组件的 VNode 及其子 VNode 全部更新后
componentUpdated: function (el, binding) {
},
unbind: function () {
},
}
//处理不同类型的权限控制
function processingType(type,value){
let values=[];
switch (type) {
case permissionType.ROLE:
return permissionByRole(value);
case permissionType.CURRENTUSER:
return permissionCreater(value);
case permissionType.BUSSINESSSTATUS:
return permissionBusinessStatus(value);
case permissionType.MIX_EVERY:
for(let type in value){
values.push(processingType(type,value[type]))
}
return values.every(v=>{
return v;
})
case permissionType.MIX_SOME:
for(let type in value){
values.push(processingType(type,value[type]))
}
return values.some(v=>{
return v;
})
default:
return false;
}
}
//业务状态判断
function permissionBusinessStatus(bindingValue){
return bindingValue.status==bindingValue.value;
}
//当前用户?
function permissionCreater(bindingValue){
const userInfo = JSON.parse(sessionStorage.CDTPcookie);
// console.log(userInfo.userInfo.id,bindingValue)
if(bindingValue instanceof Array){
return bindingValue.some(v=>{
return userInfo.userInfo.id==v;
})
}
return userInfo.userInfo.id==bindingValue;
}
//角色控制
export function permissionByRole(bindingValue) {
//这里也可以是store里的用户信息
const userInfo = JSON.parse(sessionStorage.userInfo);
let roles = []
if (userInfo) {
roles = userInfo.roleList
}
let show = false;
if (bindingValue instanceof Array) {
return roles.some(role => {//多角色处理
return bindingValue.some(item => {
return role.roleCode === item
})
})
} else if (typeof bindingValue == 'string') {
show = roles.some(role => {
return role.roleCode === bindingValue;
})
}
return show;
}
复制代码
简单说一下上面👆指令的定义思路和使用方法。整体思路就是通过 processingType 处理权限逻辑,使用 el.style.display 控制组件显示或隐藏。我在这里从日常应用中提取了一些通用的 processingType 中的权限处理方式,方便大家理解也供大家参考。
参考 vue 实战视频讲解:进入学习
下面逐一说一下权限指令各个类型的使用方法:
//角色权限
<component v-permission:role='leader'></component>
//判断当前登录人
<component v-permission:currentUser='orderInfo.createUser'></component>
//判断业务状态
<component v-permission:bussinessStatus='{status:orderStatus.RUNNING,value:orderInfo.status}'></component>
//角色是leader或者是当前订单的创建者,有权限
<component v-permission:some="{role:'leader',currentUser:'orderInfo.createUser'}"></component>
//角色是leader并且是当前订单的创建者,有权限
<component v-permission:every="{role:'leader',currentUser:'orderInfo.createUser'}"></component>
复制代码
输入限制
v-input 输入框限制,限制数字、保留 n 位小数点等。
export default {
inserted: function (el, binding, vnode) {
el.addEventListener('input', function (e) {
if (binding.arg == 'toFixed') {
//限制输入n位小数点
toFiexd(e.target, vnode, binding.value)
} else {
//限制数字输入
Integer(e.target, vnode)
}
})
},
}
function toFiexd(target, vnode, v) {
console.log(v);
let ln = 2;
if (v) {
ln = v;
}
var regStrs = [
['^0(\\d+)$', '$1'], //禁止录入整数部分两位以上,但首位为0
['[^\\d\\.]+$', ''], //禁止录入任何非数字和点
['\\.(\\d?)\\.+', '.$1'], //禁止录入两个以上的点
['^(\\d+\\.\\d{' + ln + '}).+', '$1'] //禁止录入小数点后两位以上
];
for (var i = 0; i < regStrs.length; i++) {
var reg = new RegExp(regStrs[i][0]);
target.value = target.value.replace(reg, regStrs[i][1]);
}
//对于封装的像el-input组件,因为其需要通过input事件同步状态
if(vnode.componentInstance){
vnode.componentInstance.$listeners.input(target.value)
}
}
function Integer(target, vnode) {
let valueStr = target.value
if (valueStr.length == 1) {
//第一个数字不为0
valueStr = valueStr.replace(/[^0-9]/g, "");
} else {
//只能输入正整数
valueStr = valueStr.replace(/\D/g, "");
}
target.value = valueStr;
if(vnode.componentInstance){
vnode.componentInstance.$listeners.input(target.value)
}
}
复制代码
这里需要特别注意的是下面这行代码
vnode.componentInstance.$listeners.input(target.value)
复制代码
我们为什么需要添加这一句呢,我们明明已经为 target.value 做了赋值。
实际上这一句代码相当于指令作用组件内部的$emit('input',target.value)
,这是因为如果我们是在 antd 或者 elementui 中的输入框组件上添加我们定义的 v-input 指令,直接为 target.value 赋值是不能生效的,修改的只是原生 input 控件 value 值,并没有修改自定义组件的 value,还需要通过触发 input 事件去同步组件状态,修改 value 值。(这里不了解为什么需要触发 input 事件区同步状态的同学了解一下 v-model 的语法糖原理即可理解,使用方法:
<!-- 限制输入两位小数数字 -->
<input v-input:toFixed="2"/>
<!-- 限制输入正整数 -->
<el-input v-input:integer/>
复制代码
内容处理
我们也可以通过自定义指令做对内容到处理,比如
空值处理
数字千分数逗号分割
export default {
bind:function(){
},
inserted:function(el,binding){
dealContent(el,binding)
},
update:function(el,binding){
dealContent(el,binding)
},
componentUpdated:function(){
},
unbind:function(){
},
}
function dealContent(el,binding){
const {arg}=binding;
if(arg=='empty'){
if(!el.textContent){//空值显示
el.textContent=binding.value||'暂无数据';
}
}else if(arg=='money'){//金额千分位逗号分割,如10000000显示为100,000,00
if (binding.value) {
el.textContent = dealMoney(binding.value);
}else {
el.textContent = dealMoney(el.textContent);
}
}
}
复制代码
千分位分割代码:
//金额处理
export function dealMoney(money, places = 2) {
const zero = `0.00`;
if (isNaN(money) || money === '') return zero;
if (money && money != null) {
money = `${money}`;
let left = money.split('.')[0]; // 小数点左边部分
let right = money.split('.')[1]; // 小数点右边
// 保留places位小数点,当长度没有到places时,用0补足。
right = right ? (right.length >= places ? '.' + right.substr(0, places) : '.' + right + '0'.repeat(places - right.length)) : ('.' + '0'.repeat(places));
var temp = left.split('').reverse().join('').match(/(\d{1,3})/g); // 分割反向转为字符串然后最多3个,最少1个,将匹配的值放进数组返回
return (Number(money) < 0 ? '-' : '') + temp.join(',').split('').reverse().join('') + right; // 补齐正负号和货币符号,数组转为字符串,通过逗号分隔,再分割(包含逗号也分割)反向转为字符串变回原来的顺序
} else if (money === 0) {
return zero;
} else {
return zero;
}
}
复制代码
使用方法:
<span v-content:empty="'无'">{{message}}</span>
<!-- 金额千分位逗号分割 -->
<span v-content:money>100000</span>
复制代码
文件预览
v-preview 方便的实现文件预览功能
预览图片;
预览文件;
其他预览类业务功能
import {isOffic,isPdf,isImage} from '@/utils/base'
import {previewWithOffice} from '@/utils/fileUtils.js'
export default {
inserted:function(el,binding){
el.onclick=function(e){
let params = binding.value
if(isOffic(params.name)){
e.preventDefault()
e.stopPropagation()
previewWithOffice(params.url)//使用office在线预览打开
}else if(isPdf(params.name) || isImage(params.name)){
e.preventDefault()
e.stopPropagation()
if(params.url){//直接打开url
previewFile(params)
}
}
}
},
//指令所在组件的 VNode 及其子 VNode 全部更新后
componentUpdated: function (el, binding) {
el.onclick=function(e){
let params = binding.value
if(isOffic(params.name)){
//使用插件预览Office文件
e.preventDefault()
e.stopPropagation()
previewWithOffice(params.url)
}else if(isPdf(params.name) || isImage(params.name)){
//预览图片和pdf等能直接打开的文件
e.preventDefault()
e.stopPropagation()
previewFile(params)
}
}
},
unbind(el){
el.onclick=null;
}
}
//预览图片和pdf等能直接打开的文件
function previewFile(params) {
let a = document.createElement("a");
a.download = params.name
a.href = params.url;
a.target = "_blank";
a.click();
a = null;
}
复制代码
使用方法:
<!-- 预览图片 -->
<image :src='url' v-preview="{name:file.name,url:file.url}"></image>
<!-- 预览文件 -->
<span v-preview="{name:file.name,url:file.url}">{{file.name}}</span>
复制代码
试着自己实现
各位同学可以试着自己实现一个v-loading
的加载中的指令,通过设置一个bool
值来设置容器的加载状态。如有疑问可以在评论区留言。
总结
本文主要讲了如下几件事:
vue
自定义指令介绍
实现一个v-model
通用的自定义指令使用技巧
评论