Lazyload 懒加载

介绍

当页面需要加载大量内容时,使用懒加载可以实现延迟加载页面可视区域外的内容,从而使页面加载更流畅。

引入

通过以下方式来全局注册组件,更多注册方式请参考组件注册

LazyloadVue 指令,使用前需要对指令进行注册。

  1. import { createApp } from 'vue';
  2. import { Lazyload } from 'vant';
  3. const app = createApp();
  4. app.use(Lazyload);
  5. // 注册时可以配置额外的选项
  6. app.use(Lazyload, {
  7. lazyComponent: true,
  8. });

代码演示

基础用法

v-lazy 指令的值设置为你需要懒加载的图片。

  1. <img v-for="img in imageList" v-lazy="img" />
  1. export default {
  2. setup() {
  3. return {
  4. imageList: [
  5. 'https://img.yzcdn.cn/vant/apple-1.jpg',
  6. 'https://img.yzcdn.cn/vant/apple-2.jpg',
  7. ],
  8. };
  9. },
  10. };

背景图懒加载

和图片懒加载不同,背景图懒加载需要使用 v-lazy:background-image,值设置为背景图片的地址,需要注意的是必须声明容器高度。

  1. <div v-for="img in imageList" v-lazy:background-image="img" />

组件懒加载

将需要懒加载的组件放在 lazy-component 标签中,即可实现组件懒加载。

  1. // 注册时设置`lazyComponent`选项
  2. app.use(Lazyload, {
  3. lazyComponent: true,
  4. });
  1. <lazy-component>
  2. <img v-for="img in imageList" v-lazy="img" />
  3. </lazy-component>

API

Options

参数说明类型默认值
loading加载时的图片string-
error错误时的图片string-
preload预加载高度的比例string-
attempt尝试次数number3
listenEvents监听的事件string[]scroll
adapter适配器object-
filter图片 URL 过滤object-
lazyComponent是否能懒加载模块booleanfalse

更多内容请参照:vue-lazyload 官方文档

常见问题

通过 CDN 引入 Vant 时,没有自动注册 Lazyload 组件?

由于 Lazyload 组件在注册时可以传入一些配置项,所以我们不会自动注册 Lazyload 组件,需要手动进行注册:

  1. const app = Vue.createApp();
  2. app.use(vant.Lazyload, {
  3. lazyComponent: true,
  4. });

Lazyload 懒加载 - 图1