Vue 自定义指令

2020-08-20 14:29:40 浏览数 (1)

博客地址:https://ainyi.com/94

简要说明

除了核心功能默认内置的指令 (v-model 和 v-show),Vue 也允许注册自定义指令。注意,在 Vue2.0 中,代码复用和抽象的主要形式是组件。然而,有的情况下,你仍然需要对普通 DOM 元素进行底层操作,这时候就会用到自定义指令。举个聚焦输入框的例子,如下:

代码语言:txt复制
// 注册一个全局自定义指令 `v-focus`
Vue.directive('focus', {
  // 指令的定义;当被绑定的元素插入到 DOM 中时……
  inserted: function (el) {
    // 聚焦元素
    el.focus()
  }
})

如果想注册局部指令,组件中也接受一个 directives 的选项:

代码语言:txt复制
directives: {
  focus: {
    // 指令的定义
    inserted: function (el) {
      el.focus()
    }
  }
}

然后你可以在模板中任何元素上使用新的 v-focus property,如下:

代码语言:txt复制
<input v-focus>

钩子函数

一个自定义指令,均包含一些钩子函数,像 Vue 生命周期一样,指令也有生命周期

  • bind:只调用一次,指令第一次绑定到元素时调用。在这里可以进行一次性的初始化设置
  • inserted:被绑定元素插入父节点时调用 (仅保证父节点存在,但不一定已被插入文档中)
  • update:所在组件的 VNode 更新时调用,但是可能发生在其子 VNode 更新之前。指令的值可能发生了改变,也可能没有。但是你可以通过比较更新前后的值来忽略不必要的模板更新 (详细的钩子函数参数见下)
  • componentUpdated:指令所在组件的 VNode 及其子 VNode 全部更新后调用
  • unbind:只调用一次,指令与元素解绑时调用

以上钩子函数会被传入以下参数:

==el==:指令所绑定的元素,可以用来直接操作 DOM

==binding==:一个对象,包含以下几个 property,就不展开说了,官方文档描述的也详细

==vnode==:Vue 编译生成的虚拟节点

==oldVnode==:上一个虚拟节点,仅在 update 和 componentUpdated 钩子中可用

实践:图片懒加载指令

做一个图片懒加载的指令 v-imgLazy,当图片出现在可视区域内,去加载图片

那么这里有一个非常香的 api 可以食用了 IntersectionObserver

IntersectionObserver 对象的 observe() 方法向IntersectionObserver对象监听的目标集合添加一个元素。一个监听者有一组阈值和一个根, 但是可以监视多个目标元素,以查看这些目标元素可见区域的变化

简单来说可以监听 dom 元素进出可视区域,并且可以控制具体的变化

在 src 下新建 directive 用来存放自定义指令

directive/imgLazy.ts

代码语言:txt复制
// 引入默认图片
import baseImg from '@/assets/logo.png'

let timer: any = null
// 创建一个监听器
const observer = new IntersectionObserver(entries => {
  // entries 是所有被监听对象的集合
  entries.forEach((entry: any) => {
    if (entry.isIntersecting || entry.intersectionRatio > 0) {
      // 当被监听元素到临界值且未加载图片时触发
      !entry.target.isLoaded && showImage(entry.target, entry.target.data_src)
    }
  })
})
function showImage(el: any, imgSrc: any) {
  const img = new Image()
  img.src = imgSrc
  img.onload = () => {
    el.src = imgSrc
    el.isLoaded = true
  }
}

export default {
  inserted(el: any, binding: any, vnode: any) {
    clearTimeout(timer)
    // 初始化时展示默认图片
    el.src = baseImg
    // 将需要加载的图片地址绑定在dom上
    el.data_src = binding.value
    observer.observe(el)

    // 防抖,这里在组件卸载的时候停止监听
    const vm = vnode.context
    timer = setTimeout(() => {
      vm.$on('hook:beforeDestroy', () => {
        observer.disconnect()
      })
    }, 20)
  },

  // 图片更新触发
  update(el: any, binding: any) {
    el.isLoaded = false
    el.data_src = binding.value
  }
}

可在 main.ts 注册全局指令

代码语言:txt复制
import imgLazy from '@/directive/imgLazy'

Vue.directive('imgLazy', imgLazy)

也可以在需要的组件注册局部指令

代码语言:txt复制
import imgLazy from '@/directive/imgLazy'

export default {
  directives: {
    imgLazy
  }
}

然后就可以愉快地使用 v-imgLazy 玩耍啦(v-imgLazy="imgSrc")绑定的值是图片地址

注意

IntersectionObserver 不兼容 IE,万恶的 IE 啊

如果想要兼容,只能通过计算的方式来判断是否进入可视区域了

博客地址:https://ainyi.com/94

0 人点赞