版本选择

swiper是个常用的插件,现在已经迭代到了第四代:swiper4。

常用的版本是swiper3和swiper4,我选择的是swiper3。

安装

安装swiper3的最新版本3.4.2:

```npm i swiper@3.4.2 -S ```

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

```npm view 包名 versions ```

组件编写

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

  1. 加载插件
  2. HTML内容
  3. 给Swiper定义一个大小
  4. 初始化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项目中导入swiper插件_ide

数据的获取

我用在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插件。