1. 程式人生 > >Vue封裝Swiper實現圖片輪播

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地址: 圖片輪播