1.前言
最近遇到一个需求,公司需要做一个类似facebook的搜索选择组件,我打算用el-input和el-cascader-panel结合设计。在设计过程中参考了el-cascader的源码,其中的v-clickoutside自定义指令蛮值得研究的,所以写篇文章记录下。
2.基础知识点
(1)v-directive
vue文档已经写的很清楚了,这里只贴网址:vue中文文档-自定义指令
(2)v-clickoutside
先放element-ui中的源码
//element-ui/src/utils/clickoutside.js
import Vue from 'vue';
import { on } from 'element-ui/src/utils/dom';
const nodeList = [];
const ctx = '@@clickoutsideContext';
let startClick;
let seed = 0;
!Vue.prototype.$isServer && on(document, 'mousedown', e => (startClick = e));
!Vue.prototype.$isServer && on(document, 'mouseup', e => {
nodeList.forEach(node => node[ctx].documentHandler(e, startClick));
});
function createDocumentHandler(el, binding, vnode) {
return function(mouseup = {}, mousedown = {}) {
if (!vnode ||
!vnode.context ||
!mouseup.target ||
!mousedown.target ||
el.contains(mouseup.target) ||
el.contains(mousedown.target) ||
el === mouseup.target ||
(vnode.context.popperElm &&
(vnode.context.popperElm.contains(mouseup.target) ||
vnode.context.popperElm.contains(mousedown.target)))) return;
if (binding.expression &&
el[ctx].methodName &&
vnode.context[el[ctx].methodName]) {
vnode.context[el[ctx].methodName]();
} else {
el[ctx].bindingFn && el[ctx].bindingFn();
}
};
}
/**
* v-clickoutside
* @desc 点击元素外面才会触发的事件
* @example
* ```vue
* <div v-element-clickoutside="handleClose">
* ```
*/
export default {
bind(el, binding, vnode) {
nodeList.push(el);
const id = seed++;
el[ctx] = {
id,
documentHandler: createDocumentHandler(el, binding, vnode),
methodName: binding.expression,
bindingFn: binding.value
};
},
update(el, binding, vnode) {
el[ctx].documentHandler = createDocumentHandler(el, binding, vnode);
el[ctx].methodName = binding.expression;
el[ctx].bindingFn = binding.value;
},
unbind(el) {
let len = nodeList.length;
for (let i = 0; i < len; i++) {
if (nodeList[i][ctx].id === el[ctx].id) {
nodeList.splice(i, 1);
break;
}
}
delete el[ctx];
}
};
//element-ui/src/utils/dom
export const on = (function() {
if (!isServer && document.addEventListener) {
return function(element, event, handler) {
if (element && event && handler) {
element.addEventListener(event, handler, false);
}
};
} else {
return function(element, event, handler) {
if (element && event && handler) {
element.attachEvent('on' + event, handler);
}
};
}
})();
v-clickoutside用于处理目标节点外的点击事件,最主要的是下拉框等展开内容的关闭。
这道程序使用了订阅发布的设计模式,先通过自定义的on方法(兼容addEventListener和attachEvent两个绑定方法的函数),在document中绑定mouseup和mousedown事件,两个事件分别记录鼠标按下和松开时所在的节点,之后与目标节点进行对比,如果点击元素是目标节点或者被目标节点包含在内,则触发对应的执行函数。
在执行bind周期函数时,先把该元素存放在nodeList中,且在元素中赋值一个名为“@@clickoutsideContext”的属性,这个对象里面分别存放id(用于标记元素,方便unbind周期函数中把元素从nodeList中剔除),documentHandler(存放执行函数),methodName(binding.expression),bindingFn(binding.value)。
当执行到update周期函数时,会对el中的ctx属性进行更新。执行unbind函数时,会根据el中的ctx属性中记录的id去剔除本对象。
createDocumentHandler函数会返回一个能通过闭包访问到mouseup(鼠标按下时所在的元素)和mousedown(鼠标松开时所在的元素)的函数,该函数执行时会按照以下条件判断v-clickoutside中绑定的函数是否执行:
- !vnode || !vnode.context || !mouseup.target || !mousedown.target :判断vnode和vnode.context等目标是否存在
- el.contains(mouseup.target) || el.contains(mousedown.target) || el === mouseup.target:判断当前目标节点是鼠标松开时所在的节点,或者是否包含鼠标点击或者鼠标松开时所在的元素
- (vnode.context.popperElm &(vnode.context.popperElm.contains(mouseup.target) || vnode.context.popperElm.contains(mousedown.target))):判断虚拟节点vnode中的popperElm,也就是是否存在悬浮的组件上。
当符合上面任一条件时,函数就会return,否则执行所绑定目标节点中存放在名为“@@clickoutsideContext”属性的执行方法。
3.源码的改进
分析:个人觉得el[ctx]这个设计的存在可能是便于其他作用域访问当前el所绑定的执行函数而设计的。基于我的情况,主要围绕把el[ctx]为出发点,把nodeList改成了以Map的(key,value)作保存,改进如下:
let clickInEvent
let nodeEventRecorder = new Map()
document.addEventListener('mousedown', e => (clickInEvent = e))
document.addEventListener('mouseup', e => {
nodeEventRecorder.forEach((value) => {
value(e, clickInEvent)
})
})
function createHandler (el, binding, vnode) {
return function (mouseup = {}, mousedown = {}) {
if (!vnode ||
!vnode.context ||
!mouseup.target ||
el.contains(mouseup.target) ||
el.contains(mousedown.target) ||
el === mouseup.target ||
(vnode.context.popperElm &&
(
vnode.context.popperElm.contains(mouseup.target) ||
vnode.context.popperElm.contains(mousedown.target)
)
)
) {
return
}
if (binding.expression && vnode.context[binding.expression]) {
vnode.context[binding.expression]()
} else {
if (typeof (binding.value) === 'function') {
binding.value()
} else {
throw new Error('value should be a function')
}
}
}
}
let directive = {
bind (el, binding, vnode) {
nodeEventRecorder.set(el, createHandler(el, binding, vnode))
},
update (el, binding, vnode) {
nodeEventRecorder.set(el, createHandler(el, binding, vnode))
},
unbind (el) {
nodeEventRecorder.delete(el)
}
}
有人会问为什么不用Object作为储存映射的容器类型,那是因为Object的key只能是字符串或者Symbol类型的数据。而Map的Key可以是任何数据类型,包括节点。
用Map替换后也不存在el[ctx]和seed++这类变量了。在unbind中执行删除操作时也不需要遍历列表这么麻烦了。
实现的效果如下: