v-clickoutside的源码分析及改进

比特筑梦说
• 阅读 3171

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中绑定的函数是否执行:

  1. !vnode || !vnode.context || !mouseup.target || !mousedown.target :判断vnode和vnode.context等目标是否存在
  2. el.contains(mouseup.target) || el.contains(mousedown.target) || el === mouseup.target:判断当前目标节点是鼠标松开时所在的节点,或者是否包含鼠标点击或者鼠标松开时所在的元素
  3. (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)
  }
}

export default directive

有人会问为什么不用Object作为储存映射的容器类型,那是因为Object的key只能是字符串或者Symbol类型的数据。而Map的Key可以是任何数据类型,包括节点。

用Map替换后也不存在el[ctx]和seed++这类变量了。在unbind中执行删除操作时也不需要遍历列表这么麻烦了。

实现的效果如下:v-clickoutside的源码分析及改进

点赞
收藏
评论区
推荐文章
blmius blmius
3年前
MySQL:[Err] 1292 - Incorrect datetime value: ‘0000-00-00 00:00:00‘ for column ‘CREATE_TIME‘ at row 1
文章目录问题用navicat导入数据时,报错:原因这是因为当前的MySQL不支持datetime为0的情况。解决修改sql\mode:sql\mode:SQLMode定义了MySQL应支持的SQL语法、数据校验等,这样可以更容易地在不同的环境中使用MySQL。全局s
Wesley13 Wesley13
3年前
MySQL部分从库上面因为大量的临时表tmp_table造成慢查询
背景描述Time:20190124T00:08:14.70572408:00User@Host:@Id:Schema:sentrymetaLast_errno:0Killed:0Query_time:0.315758Lock_
美凌格栋栋酱 美凌格栋栋酱
6个月前
Oracle 分组与拼接字符串同时使用
SELECTT.,ROWNUMIDFROM(SELECTT.EMPLID,T.NAME,T.BU,T.REALDEPART,T.FORMATDATE,SUM(T.S0)S0,MAX(UPDATETIME)CREATETIME,LISTAGG(TOCHAR(
皕杰报表之UUID
​在我们用皕杰报表工具设计填报报表时,如何在新增行里自动增加id呢?能新增整数排序id吗?目前可以在新增行里自动增加id,但只能用uuid函数增加UUID编码,不能新增整数排序id。uuid函数说明:获取一个UUID,可以在填报表中用来创建数据ID语法:uuid()或uuid(sep)参数说明:sep布尔值,生成的uuid中是否包含分隔符'',缺省为
Wesley13 Wesley13
3年前
VBox 启动虚拟机失败
在Vbox(5.0.8版本)启动Ubuntu的虚拟机时,遇到错误信息:NtCreateFile(\\Device\\VBoxDrvStub)failed:0xc000000034STATUS\_OBJECT\_NAME\_NOT\_FOUND(0retries) (rc101)Makesurethekern
Wesley13 Wesley13
3年前
FLV文件格式
1.        FLV文件对齐方式FLV文件以大端对齐方式存放多字节整型。如存放数字无符号16位的数字300(0x012C),那么在FLV文件中存放的顺序是:|0x01|0x2C|。如果是无符号32位数字300(0x0000012C),那么在FLV文件中的存放顺序是:|0x00|0x00|0x00|0x01|0x2C。2.  
Wesley13 Wesley13
3年前
mysql设置时区
mysql设置时区mysql\_query("SETtime\_zone'8:00'")ordie('时区设置失败,请联系管理员!');中国在东8区所以加8方法二:selectcount(user\_id)asdevice,CONVERT\_TZ(FROM\_UNIXTIME(reg\_time),'08:00','0
Wesley13 Wesley13
3年前
PHP创建多级树型结构
<!lang:php<?php$areaarray(array('id'1,'pid'0,'name''中国'),array('id'5,'pid'0,'name''美国'),array('id'2,'pid'1,'name''吉林'),array('id'4,'pid'2,'n
Easter79 Easter79
3年前
SpringBoot整合Redis乱码原因及解决方案
问题描述:springboot使用springdataredis存储数据时乱码rediskey/value出现\\xAC\\xED\\x00\\x05t\\x00\\x05问题分析:查看RedisTemplate类!(https://oscimg.oschina.net/oscnet/0a85565fa
Wesley13 Wesley13
3年前
Java日期时间API系列36
  十二时辰,古代劳动人民把一昼夜划分成十二个时段,每一个时段叫一个时辰。二十四小时和十二时辰对照表:时辰时间24时制子时深夜11:00凌晨01:0023:0001:00丑时上午01:00上午03:0001:0003:00寅时上午03:00上午0
Python进阶者 Python进阶者
1年前
Excel中这日期老是出来00:00:00,怎么用Pandas把这个去除
大家好,我是皮皮。一、前言前几天在Python白银交流群【上海新年人】问了一个Pandas数据筛选的问题。问题如下:这日期老是出来00:00:00,怎么把这个去除。二、实现过程后来【论草莓如何成为冻干莓】给了一个思路和代码如下:pd.toexcel之前把这