vue3批量注册全局组件及封装自定义指令(图片懒加载)

// 扩展vue原有的功能：全局组件，自定义指令，挂载原型方法，注意：没有全局过滤器。
// 这就是插件
// vue2.0插件写法要素：导出一个对象，有install函数，默认传入了Vue构造函数，Vue基础之上扩展
// vue3.0插件写法要素：导出一个对象，有install函数，默认传入了app应用实例，app基础之上扩展

import defaultImg from '@/assets/images/200.png'
// 导入library文件夹下的所有组件
/**
 *  批量导入需要使用一个函数 require.context(directory,useSubdirectories,regExp)
 *  require.context(directory,useSubdirectories,regExp)
 *  directory:  表示检索的目录
    useSubdirectories: 表示是否检索子文件夹
    regExp:  匹配文件的正则表达式,一般是文件名
    console.dir(importFn.keys()) // 文件名称数组
 */
const importFn = require.context('./', false, /.vue$/)
export default {
  install (app) {
    // 在app上进行扩展，app提供 component directive 函数
    // 如果要挂载原型 app.config.globalProperties 方式
    // 第一个参数要写name, 不然就是 undefined
    // app.component(XtxSkeleton.name, XtxSkeleton) //   骨架效果
    // app.component(XtxCarousel.name, XtxCarousel) //   轮播图
    // app.component(XtxMore.name, XtxMore) //   查看更多
    // app.component(XtxBread.name, XtxBread) //   面包屑
    // app.component(XtxBreadItem.name, XtxBreadItem) //   面包屑

    // 批量注册全局组件
    importFn.keys().forEach(item => {
      // 导入组件
      const component = importFn(item).default
      // 注册组件
      app.component(component.name, component)
    })
    // 定义指令
    defineDirective(app)
  }
}

// 自定义指令
const defineDirective = (app) => {
  // 1. 图片懒加载指令  v-lazy
  // 原理：先存储图片地址，不能在src上，当图片进入可视区，将你存储图片地址设置给图片元素即可
  app.directive('lazy', {
    // vue2.0 监听使用指令的 DOM 是否创建好 ， 钩子函数 inserted
    // vue3.0 的指令用用的猴子函数和组件的一样，使用指令的 DOM 是否创建好，钩子函数 : mounted
    mounted (el, binding) {
      // 2. 创建一个观察对象，来观察当前使用指令的元素
      const observer = new IntersectionObserver(([{ isIntersecting }]) => {
        if (isIntersecting) {
          // 停止观察
          observer.unobserve(el)
          // 4. 处理图片加载失败
          el.onerror = () => {
            // 加载失败，设置默认图
            el.src = defaultImg
          }
          // 3. 把指令的值设置给 el 的 src 属性 binding.value 就是指令的值
          el.src = binding.value
        }
      }, {
        // threshold 容器和可视区交叉的占比（进入的面积/容器完整面试） 取值，0-1 之间，默认比0大，所以需要滚动较多才能触发进入可视区域事件。
        threshold: 0
      })
      // 开启观察
      observer.observe(el)
    }
  })
}

// 创建观察对象实例
// const observer = new IntersectionObserver(callback[, options])
// callback 被观察dom进入可视区离开可视区都会触发
// - 两个回调参数 entries , observer
// - entries 被观察的元素信息对象的数组 [{元素信息},{}]，信息中isIntersecting判断进入或离开
// - observer 就是观察实例
// options 配置参数
// - 三个配置属性 root rootMargin threshold
// - root 基于的滚动容器，默认是document
// - rootMargin 容器有没有外边距
// - threshold 交叉的比例

// 实例提供两个方法
// observe(dom) 观察哪个dom
// unobserve(dom) 停止观察那个dom