Vue.directive 实现元素scroll逻辑复用

前言

继上篇 Vue 滚动触底 mixins,将对于文档滚动触底的逻辑迁移到某个dom上，将会用到 Vue.directive 来实现代码逻辑复用。

元素滚动

如何实现滚动

元素实现滚动的条件有两个:

1. 有父子两个元素
2. 子元素的高度 > 父元素的高度, 而且父元素设置 overflow:scroll / auto;

   

scrollHeight 计算

Element.scrollHeight这个只读属性是一个元素内容高度的度量，包括因为溢出致使的视图中不可见内容。

能够简单的理解为，滚动高度是元素能够滚动的最大值，分为两种状况

1. 当元素不知足滚动条件时，滚动高度 = 当前元素的 clientHeight = height + padding
2. 当元素知足滚动条件时, 滚动高度 = 当前元素的padding + 子元素的clientHeight + 子元素的(padding,margin,border) + 伪元素(:after,:before)

scrollTop

Element.scrollTop 属性能够获取或设置一个元素的内容垂直滚动的像素数。

须要注意的是，scrollTop 是针对产生滚动条的元素而言，因此分为两种状况

1. 不符合滚动条件, scrollTop 为0
2. 符合滚动条件，能够经过 Element.scrollTop 来获取它的子元素的顶部到父级元素顶部的距离，不包括(border,padding)。

判断触底

为了简单起见，假设 father 和 child 都只设置了宽高。

<div class="father" ref="father">
  <div class="child" ref="child"></div>
</div>
// 若为真说明触底
father.clientHeight + father.scrollTop >= child.scrollHeight
复制代码

抽离成 Vue-directive

基本语法

参数1
指令名称，如focus 使用的时候就经过 v-focus 去绑定指定dom

参数2
options配置项，包含如下的钩子函数，分别在对应的生命周期触发

// 注册一个全局自定义指令 `v-focus`
Vue.directive('focus', {
  bind(){
    // 只调用一次，指令第一次绑定到元素时调用。在这里能够进行一次性的初始化设置。
  },
  // 当被绑定的元素插入到 DOM 中时……
  inserted: function (el) {
    // 聚焦元素
    el.focus()
  },
  update(){
    // 所在组件的 VNode 更新时调用
  },
  componentUpdated(){
    // 指令所在组件的 VNode 及其子 VNode 所有更新后调用。
  },
  unbind(){
    // 只调用一次，指令与元素解绑时调用。
  }
})
复制代码

钩子函数的回调参数

上面的钩子函数都接受 el、binding、vnode 和 oldVnode这些回调参数，对经常使用的参数作下解释

• el : 指令所绑定的元素，能够用来直接操做 DOM 。
• binding : { name,value ,arg}
  • name 指令名称
  • value 指令的绑定值，是绑定组件的data中的变量名
  • arg 传给指令的参数，可选。例如 v-my-directive:foo 中，参数为 "foo"。 注册或获取全局指令。

来讲下 value 和 arg 的区别，假设咱们想向指令传递特定的数据，能够经过下面的方式arg传递值，和 value绑定值只能使用一种

// 经过 binding.value 接收
<div v-test="title">这里是测试</div>
// 经过 binding.arg 接收
<div v-test:id1>测试2</div>
复制代码

如何注册指令

1. 全局注册

// 在单独一个文件中单独管理全部 directive 
import Vue from 'vue'
import inputClear from './input-clear'
import forNested from './picker-item-for-nested'
import copy from "./copy";

const directives = {
  copy,
  'input-clear':inputClear,
  'for-nested':forNested
}
Object.keys(directives).forEach(key=>{
  Vue.directive(key,directives[key])
})
复制代码

2. 局部注册,经过directives选项来注册

export default {
  directives:{
    // 自定义指令的名字
    autoFocus:{
      inserted(el){
        el.focus()
        console.log( 'inserted' );
      }
    }
  }
}
复制代码

3. Vue.install的方式来安装

// directive.js
export default {
  install(Vue){
    Object.keys(directives).forEach(key=>{
      Vue.directive(key,directives[key])
    })
  }
}

// main.js
import Directives from "./directive/index";
// Vue.use 经过注册插件的方式来注册指令 `Vue 插件中 install 函数接受 Vue构造函数做为第一入参`
Vue.use(Directives);
复制代码

4. Vue.use 源码

// 接收一个 plugin 参数能够是 Function 也能够是 Object
  Vue.use = function (plugin: Function | Object) {
    // 若是传入的是对象，须要有一个install 方法，并执行该方法
    if (typeof plugin.install === 'function') {
      plugin.install.apply(plugin, args)
    // 若是传入的是是函数则当即执行
    } else if (typeof plugin === 'function') {
      plugin.apply(null, args)
    }
  }
复制代码

将scroll 逻辑添加到 v-directive 中

若是子元素有多个，须要计算每一个子元素的 height + padding + border + margin 因此为了方便使用，滚动目标的子元素有多个的状况下，用一个标签统一包裹

function isBottom(el){
  const child = el.children[0]
  if(el.clientHeight + el.scrollTop >= child.scrollHeight){
    console.log('触底了');
  }
}
Vue.directive('scroll',{
  bind(el){
    el.addEventListener('scroll',function(){
      isBottom(el)
    })
  },
  unbind(el){
    el.removeEventListener(isBottom)
  }
})
复制代码

最后

重点:

1. 实现滚动的条件
2. 滚动触底判断的依据
   若是想将 v-scroll 不单单使用元素中，也能够将 Vue 滚动触底 mixins的逻辑添加进来