mingyunyuziyou

Vue中使用图片懒加载vue-lazyload插件详细指南

作者: 秒速五厘米     
 


说明

当网络请求比较慢的时候,提前给这张图片添加一个像素比较低的占位图片,不至于堆叠在一块,或显示大片空白,让用户体验更好一点。

使用方式

使用vue的 vue-lazyload 插件
插件地址:

https://www.npmjs.com/package/vue-lazyload

案例

demo: 懒加载案例demo

Installation 安装方式


npm

$ npm i vue-lazyload -D

CDN

CDN: https://unpkg.com/vue-lazyload/vue-lazyload.js

<script src="https://unpkg.com/vue-lazyload/vue-lazyload.js"></script><script>
  Vue.use(VueLazyload)
  ...</script>

用法

main.js 在入口文件

import Vue from 'vue'
import App from './App.vue'
import VueLazyload from 'vue-lazyload'  //引入这个懒加载插件

Vue.use(VueLazyload)

// 或者添加VueLazyload 选项
Vue.use(VueLazyload, {
  preLoad: 1.3,
  error: 'dist/error.png',
  loading: 'dist/loading.gif',
  attempt: 1
})

new Vue({
  el: 'body',
  components: {
    App
  }
})

在入口文件添加后,在组件任何地方都可以直接使用把 img 里的:src -> v-lazy

 <div class="pic">    <a href="#"><img :src="'/static/img/' + item.productImage" alt=""></a></div>
 //把之前项目中img 标签里面的 :src 属性 改成 v-lazy 
 <div class="pic">    <a href="#"><img v-lazy="'/static/img/' + item.productImage" alt=""></a></div>

参数选项说明

keydescriptiondefaultoptions
preLoadproportion of pre-loading height1.3Number
error当加载图片失败的时候'data-src'String
loading当加载图片成功的时候'data-src'String
attempt尝试计数3Number


listenEvents


想要监听的事件


['scroll', 'wheel',

 'mousewheel', 'resize',

 'animationend',

 'transitionend', 

'touchmove']


Desired Listen Events
adapter动态修改元素属性{ }Element Adapter
filter图片监听或过滤器{ }Image listener filter
lazyComponentlazyload componentfalseLazy Component
dispatchEvent触发dom事件falseBoolean
throttleWaitthrottle wait200Number
observeruse IntersectionObserverfalseBoolean
observerOptionsIntersectionObserver options{ rootMargin: '0px', threshold: 0.1 }IntersectionObserver

想要监听的事件

您可以通过传递数组来配置想要使用vue - lazyload的事件
监听器的名字。

Vue.use(VueLazyload, {
  preLoad: 1.3,
  error: 'dist/error.png',
  loading: 'dist/loading.gif',
  attempt: 1,
  // the default is ['scroll', 'wheel', 'mousewheel', 'resize', 'animationend', 'transitionend']
  listenEvents: [ 'scroll' ]
})



git:https://github.com/hilongjw/vue-lazyload