vue-lazyload-img-plugin v1.1.0

vue-lazuload-img-plugin

vue loader 插件 —— 图片懒加载以及自动压缩（包括背景图、富文本）

🌟🌟🌟 老项目优化利器， 无需动任何业务代码 🌟🌟🌟，如src批量改成data-src之类的操作， webpack 引入本插件即可实现全局图片性能优化，具体操作详见下文

压缩技术支持来自 —— 《阿里云 oss-图片高级压缩》

1. 有设置固定宽高时（如 <img width="200" /> ）

   判断 图片过小时minSize=64不压缩，如 icon 图标 判断 图片过大时maxSize=16393不压缩，oss 不支持压缩高/宽超过 16383px

2. 未设置固定高宽时（利用图片自身natural高宽占位渲染，常见于富文本）

   先 渐进式加载（1%质量图q_1 ） 以获取占位宽高，并添加 onload 事件 在 onload 事件中继续执行上述【操作 1 】

Install

npm i vue-lazyload-img-plugin

1. Vue 项目使用步骤

第一步 vue.config.js 配置

原理：利用 loader 将<img src>修改为<img src='{thumbnail src}' data-src='{origin src}'>

// vue.config.js
const lazyloadImgVueConfig = require('vue-lazyload-img-plugin').LazyloadImgVueConfig

// ...

chainWebpack(config) {
  // ...
  lazyloadImgVueConfig(config,options);//options同webpack config
}

如果没有vue.config.js而是用的webpack.config.js配置

// webpack config
const lazyloadImgWebpackLoader =
  require("vue-lazyload-img-plugin").LazyloadImgWebpackLoader;

{
  resolve: {
    alias: {
      '@': rootPath('src'),
      vue$: 'vue/dist/vue.esm.js',
      images: rootPath('src/assets/images'),
    },
  },
  module: {
    rules: [
      lazyloadImgWebpackLoader(options:{alias:['@','vue$','images']}), //详见目录##config options
      // 如果有配'vue-loader'请注释掉代码，否则会有loader重复冲突
      // {
      // test: /\.vue$/,
      // loader: 'vue-loader',
      // },
    ];
  }
}

config options

第二步 Vue.use(plugin) 安装插件

原理：利用 plugin 在 vue 组件的 beforeCreate 阶段监听 img dom 的生成和可视区域监听 当 img 可视时，再将 origin 资源加载到当前 img 上

/main.js文件

import { LazyLoadImgPlugin } from "vue-lazyload-img-plugin";

Vue.use(LazyLoadImgPlugin, pluginOptions); // options见目录#plugin options

plugin options

maxSize说明: Maximum width and height allowed is 16383 pixels for converting webp.

2. html 标签属性补充

可在 html 标签内添加额外配置属性

<!-- 图片不接受懒加载 -->
<img src="" v-no-lazyload />

<!-- 图片不接受压缩 -->
<img src="" v-no-compress />

<!-- 背景图片不接受懒加载和压缩 -->
<div style="background:url('')" v-no-lazyload v-no-compress></div>

<!-- 禁止本插件对此标签的任何改动 -->
<img src="" v-no-compile />
<!-- 只支持一层标签，暂不支持为父标签设置后影响子标签的行为 -->
<div style="background:url('')" v-no-compile></div>

<!-- 🌟 可通过主动添加query参数覆盖动态压缩参数 -->
<img
  src="http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,p_50"
/>

<!-- 富文本内所有图片不接受懒加载 -->
<div v-html="..." v-no-lazyload></div>
<!-- 富文本内所有图片和背景图都不支持压缩 -->
<div v-html="..." v-no-compress></div>
<!-- 禁止本插件对富文本有任何改动 -->
<div v-html="..." v-no-compile></div>

3. tips

1. 存在 DOM 操作时，请在$nextTick回调后执行

   mounted(){
    this.$nextTick(() => {
      // DOM操作
      ...
    });
   }

2. 图片源资源地址被存储在data-origin-src中

   // 可从这里获取源地址
   img.dataset.originSrc;

3. 为<img/>提前设定好高宽就可以减少一次服务器请求