实战：vue项目中导入swiper插件

最新推荐文章于 2024-04-29 15:36:22 发布

weixin_34410662

最新推荐文章于 2024-04-29 15:36:22 发布

阅读量424

点赞数

CC 4.0 BY-SA版权

文章标签： javascript 数据结构与算法 ViewUI

原文链接：https://segmentfault.com/a/1190000013044682

本文介绍如何在Vue项目中使用Swiper插件实现轮播图效果，并详细讲解了从安装配置到数据渲染及动态初始化的过程。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

版本选择

swiper是个常用的插件，现在已经迭代到了第四代：swiper4。
常用的版本是swiper3和swiper4，我选择的是swiper3。

安装

安装swiper3的最新版本3.4.2:

npm i swiper@3.4.2 -S

这里一个小知识，查看node包的所有版本号的方法：

npm view 包名 versions

组件编写

swiper官方的使用方法分为4个流程：

加载插件
HTML内容
给Swiper定义一个大小
初始化Swiper

我也按照这个流程编写组件：

加载插件

import Swiper from 'swiper';
import 'swiper/dist/css/swiper.min.css';

HTML内容

<template>
    <div class="swiper-container">
        <div class="swiper-wrapper">
            <div class="swiper-slide">Slide 1</div>
            <div class="swiper-slide">Slide 2</div>
            <div class="swiper-slide">Slide 3</div>
        </div>
        <!-- 如果需要分页器 -->
        <div class="swiper-pagination"></div>
        <!-- 如果需要导航按钮 -->
        <div class="swiper-button-prev"></div>
        <div class="swiper-button-next"></div>
        <!-- 如果需要滚动条 -->
        <div class="swiper-scrollbar"></div>
    </div>
</template>

给Swiper定义一个大小

.swiper-container {
    width: 600px;
    height: 300px;
}

初始化Swiper

因为dom渲染完成才能初始化Swiper，所以必须将初始化放入vue的生命周期钩子函数mounted中：

mounted(): {
    /* eslint-disable no-new */
    new Swiper('.swiper-container', {})
}

以上代码中的/* eslint-disable no-new */是启用的eslint代码检测的项目可以使用，如果没有使用eslint可用使用一下代码：

mounted(): {
    var mySwiper = new Swiper('.swiper-container', {})
}

完成？

将以上的代码合并起来：

<template>
    <div class="swiper-container">
        <div class="swiper-wrapper">
            <div class="swiper-slide">Slide 1</div>
            <div class="swiper-slide">Slide 2</div>
            <div class="swiper-slide">Slide 3</div>
        </div>
        <!-- 如果需要分页器 -->
        <div class="swiper-pagination"></div>
        <!-- 如果需要导航按钮 -->
        <div class="swiper-button-prev"></div>
        <div class="swiper-button-next"></div>
        <!-- 如果需要滚动条 -->
        <div class="swiper-scrollbar"></div>
    </div>
</template>

<script>
import Swiper from 'swiper';
import 'swiper/dist/css/swiper.min.css';
export default {
    mounted(): {
        var mySwiper = new Swiper('.swiper-container', {})
    }
}
</script>

<style>
.swiper-container {
    width: 600px;
    height: 300px;
}
</style>

运行，你看可以实现轮播图的效果了。但是到此为止只实现了轮播的效果，还没有对数据的渲染。

对数据的渲染

在实际项目中swiper插件常用于实现banner图的效果（新浪手机版）：

图片描述

数据的获取

我用在vue项目中常用ajax插件axios来示例：

axios
  .get('/user?ID=12345')
  .then(function (response) {
    this.imgList = response;
  })
  .catch(function (error) {
    console.log(error);
  });

将获取数据的数据结构规定为：

[
    "https://www.baidu.com/img/baidu_jgylogo3.gif",
    "https://www.baidu.com/img/baidu_jgylogo3.gif",
    "https://www.baidu.com/img/baidu_jgylogo3.gif",
    "https://www.baidu.com/img/baidu_jgylogo3.gif",
    "https://www.baidu.com/img/baidu_jgylogo3.gif"
]

列表渲染

<template>
    <div class="swiper-container">
        <div class="swiper-wrapper">
            <div class="swiper-slide" v-for="item in imgList" :style="{backgroundImage: 'url(' + item + ')'}"></div>
        </div>
        <!-- 如果需要分页器 -->
        <div class="swiper-pagination"></div>
        <!-- 如果需要导航按钮 -->
        <div class="swiper-button-prev"></div>
        <div class="swiper-button-next"></div>
        <!-- 如果需要滚动条 -->
        <div class="swiper-scrollbar"></div>
    </div>
</template>

<style>
.swiper-slide {
    width: 100%;
    height: 400px;
}
<style>

到此为止已经将数据渲染完成了，但是查看实际效果，似乎banner无法实现轮播图的效果啊。这里只是将图片渲染了出来，但是渲染出轮播图并没有被初始化。因为初始化已经在生命周期mounted时完成了。

初始化

所以在获取数据且DOM更新后，需要重新初始化swiper。

axios
  .get('/user?ID=12345')
  .then(function (response) {
    // 获取数据更新
    this.imgList = response;
    // DOM还没有更新
    this.$nextTick(() => {
        // DOM更新了
        // swiper重新初始化
        /* eslint-disable no-new */
        new Swiper('.swiper-container', {})
    })
  })
  .catch(function (error) {
    console.log(error);
  });

到此，轮播图的效果实现了。

总结

swiper是我们平时很常用的插件，但将swiper导入vue项目中遇到的问题不少。最主要的问题是要搞懂vue的生命周期，这样才能有效地使用各种js插件。