Vue封裝Swiper實現圖片輪播
圖片輪播是前端中經常需要實現的一個功能。最近學習Vue.js,就針對Swiper進行封裝,實現一個簡單的圖片輪播元件。
一、Swiper
在實現封裝之前,先介紹一下Swiper。
Swiper是純Javascript打造的滑動特效外掛,面向手機、平板電腦等移動終端。
Swiper能實現觸屏焦點圖、觸屏Tab切換、觸屏多圖切換等常用效果。
Swiper開源、免費、穩定、使用簡單、功能強大,是架構移動終端網站的重要選擇。
Swiper的應用場景廣泛,實現效果很好,下面個這實際案例就是Swiper的典型應用場景。
Swiper的具體使用教程及詳細API,參考Swiper中文網
二、Vue元件
Vue元件設計初衷就是要配合使用的,提高維護性和複用性。而圖片輪播正適合使用元件來完成,因此在介紹具體的實現之前,先介紹下關於Vue元件及元件通訊。
Vue元件中最常見的就是形成父子元件的關係:元件 A 在它的模板中使用了元件 B。
它們之間必然需要相互通訊:父元件可能要給子元件下發資料,子元件則可能要將它內部發生的事情告知父元件。然而,通過一個良好定義的介面來儘可能將父子元件解耦也是很重要的。這保證了每個元件的程式碼可以在相對隔離的環境中書寫和理解,從而提高了其可維護性和複用性。
在 Vue 中,父子元件的關係可以總結為 prop 向下傳遞,事件向上傳遞。父元件通過 prop 給子元件下發資料,子元件通過事件給父元件傳送訊息。
三、封裝實現
1.引入Swiper
首先,需要安裝Swiper。
npm install --save swiper
然後,要引用兩個檔案。
import Swiper from "swiper";
import "swiper/dist/css/swiper.min.css";
2.HTML程式碼
在模板中設定輪播圖的html佈局。
<template>
<div class="swiper-container" :class="swipeid">
<div class="swiper-wrapper">
<!-- 存放具體的輪播內容 -->
<slot name ="swiper-con"></slot>
</div>
<!-- 分頁器 -->
<div :class="{'swiper-pagination':pagination}"></div>
</div>
</template>
其中使用具名插槽,提高解耦,使得在父元件使用時,根據不同情況,設定不同的輪播內容。
另外需要設定分頁器,即圖片輪播中的頁面指示器,常見的如小圓點,或者數字指示器。
3.初始化Swiper
既然是對Swiper進行封裝實現輪播圖,前面也已經安裝了Swiper,那麼現在就需要初始化使用。
在初始化之前,根據Swiper用法的瞭解,先確定輪播元件需要的屬性資訊,然後通過父元件傳遞給封裝的Swiper元件。
這時候就需要用到props。
props: {
swipeid: {
type: String,
default: ""
},
effect: {
type: String,
default: "slide"
},
loop: {
type: Boolean,
default: false
},
direction: {
type: String,
default: "horizontal"
},
pagination: {
type: Boolean,
default: true
},
paginationType: {
type: String,
default: "bullets"
},
autoPlay: {
type: Number,
default: 3000
}
}
下面逐一解釋每個屬性的含義。
屬性 | 含義 |
---|---|
swiped | 輪播容器class屬性的類名。 |
effect | 圖片的 切換效果,預設為”slide”,還可設定為”fade”, “cube”, “coverflow”,”flip”,詳情見effect。 |
loop | 設定為true 則開啟loop模式。loop模式:會在原本圖片前後複製若干個圖片並在合適的時候切換,讓Swiper看起來是迴圈的,詳情見loop。 |
direction | 圖片的滑動方向,可設定水平(horizontal)或垂直(vertical),詳情見direction。 |
pagination | |
paginationType | 分頁器樣式型別,可設定為”bullets”, “fraction”, “progressbar”, “custom”,詳情見type。 |
autoPlay | 設定為true啟動自動切換,並使用預設的切換設定,詳情見autoplay。 |
瞭解了上面每個屬性的含義,下面就可以初始化Swiper,並設定具體的屬性。
初始化Swiper時,需要傳入兩個引數。
- 輪播容器的類名
- 代表圖片輪播元件詳細功能的物件
var that = this;
this.dom = new Swiper("." + that.swipeid, {
//迴圈
loop: that.loop,
//分頁器
pagination: {
el: ".swiper-pagination",
bulletClass : 'swiper-pagination-bullet',
},
//分頁型別
paginationType: that.paginationType,
//自動播放
autoPlay: that.autoPlay,
//方向
direction: that.direction,
//特效
effect: that.effect,
//使用者操作swiper之後,不禁止autoplay
disableOnInteraction: false,
//修改swiper自己或子元素時,自動初始化swiper
observer: true,
//修改swiper的父元素時,自動初始化swiper
observeParents: true
});
}
四、自定義輪播效果
經過上面的步驟,輪播器就封裝好了。我們可以自定義實現自己想要的輪播器效果。下面以知乎的API為例,實現圖片輪播。
1.HTML程式碼
<m-swipe swipeid="swipe" ref="swiper" :autoPlay="3000" effect="slide">
<div v-for="top in tops" :key="top.id" class="swiper-slide" slot="swiper-con" >
<img :src="top.image">
<h3>{{top.title}}</h3>
</div>
</m-swipe>
首先要引用註冊元件,這裡就不詳細寫出。
其中m-swipe
就是前面實現的圖片輪播元件,而其中的子元件就是通過具名插槽插入的輪播內容。
2.CSS程式碼
.swiper-container {
width: 100%;
}
.swiper-slide {
height: 8rem;
overflow: hidden;
position: relative;
}
.swiper-slide {
div {
top: 0;
left: 0;
width: 100%;
height: 100%;
opacity: 0.4;
position: absolute;
background-color: @blue;
}
img {
top: 50%;
position: relative;
transform: translate(0, -50%);
}
h3 {
width: 70%;
color: #fff;
margin: 0;
font-size: 0.5rem;
line-height: 1rem;
right: 5%;
bottom: 2.6rem;
text-align: right;
position: absolute;
text-shadow: 1px 1px 10px rgba(0, 0, 0, 0.5);
&:before {
content: "";
width: 3rem;
bottom: -0.6rem;
right: 0;
display: block;
position: absolute;
border: 2px solid @yellow;
}
}
}
.swiper-pagination-bullet-active {
background: #fff;
}
.swiper-container-horizontal > .swiper-pagination-bullets {
bottom: 1rem;
width: 95%;
text-align: right;
}
其中swiper-pagination-bullet-active
代表分頁器中當前指示的小圓點的類名。swiper-pagination-bullets
代表分頁器的類名,詳情見pagination分頁器內元素的類名。
關於網路請求資料展示的程式碼就不貼了,下面有原始碼地址。
3.效果
這只是一個簡單的封裝效果,想要實現更多的效果,可以通過Swiper中提供的更多功能來實現。
Github地址: 圖片輪播