版本选择css
swiper是个经常使用的插件,如今已经迭代到了第四代:swiper4。html
经常使用的版本是swiper3和swiper4,我选择的是swiper3。vue
安装node
安装swiper3的最新版本3.4.2:ios
1
|
npm i swiper@3.4.2 -S
|
这里一个小知识,查看node包的全部版本号的方法:ajax
1
|
npm view 包名 versions
|
组件编写npm
swiper官方的使用方法分为4个流程:axios
我也按照这个流程编写组件:bash
加载插件数据结构
1
2
|
import Swiper from
'swiper'
;
import
'swiper/dist/css/swiper.min.css'
;
|
HTML内容
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
<
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定义一个大小
1
2
3
4
|
.swiper-container {
width
:
600px
;
height
:
300px
;
}
|
初始化Swiper
由于dom渲染完成才能初始化Swiper,因此必须将初始化放入vue的生命周期钩子函数mounted中:
1
2
3
4
|
mounted(): {
/* eslint-disable no-new */
new
Swiper(
'.swiper-container'
, {})
}
|
以上代码中的/* eslint-disable no-new */是启用的eslint代码检测的项目可使用,若是没有使用eslint可用使用一下代码:
1
2
3
|
mounted(): {
var
mySwiper =
new
Swiper(
'.swiper-container'
, {})
}
|
完成
将以上的代码合并起来:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
|
<
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来示例:
1
2
3
4
5
6
7
8
|
axios
.get(
'/user?ID=12345'
)
.then(
function
(response) {
this
.imgList = response;
})
.
catch
(
function
(error) {
console.log(error);
});
|
将获取数据的数据结构规定为:
列表渲染
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
<
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。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
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插件。