Vant4 Lazyload 懒加载

介绍

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

引入

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

Lazyload​ 是 ​Vue​ 指令,使用前需要对指令进行注册。

import { createApp } from vue;
import { Lazyload } from vant;

const app = createApp();
app.use(Lazyload);

// 注册时可以配置额外的选项
app.use(Lazyload, {
  lazyComponent: true,
});

代码演示

基础用法

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

<img v-for="img in imageList" v-lazy="img" />
export default {
  setup() {
    return {
      imageList: [
        https://fastly.jsdelivr.net/npm/@vant/assets/apple-1.jpeg,
        https://fastly.jsdelivr.net/npm/@vant/assets/apple-2.jpeg,
      ],
    };
  },
};

背景图懒加载

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

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

组件懒加载

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

// 注册时设置`lazyComponent`选项
app.use(Lazyload, {
  lazyComponent: true,
});
<lazy-component>
  <img v-for="img in imageList" v-lazy="img" />
</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 组件,需要手动进行注册:

const app = Vue.createApp();

app.use(vant.Lazyload, {
  lazyComponent: true,
});

作者:andy,如若转载,请注明出处:https://www.web176.com/vant4/18897.html

(0)
打赏 支付宝 支付宝 微信 微信
andy的头像andy
上一篇 2023年4月28日
下一篇 2023年4月28日

相关推荐

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注