Vue封裝Swiper實現圖片輪播

Ruheng發表於2018-02-06
Vue封裝

圖片輪播是前端中經常需要實現的一個功能。最近學習Vue.js，就針對Swiper進行封裝，實現一個簡單的圖片輪播元件。

一、Swiper

在實現封裝之前，先介紹一下Swiper。

  • Swiper是純Javascript打造的滑動特效外掛，面向手機、平板電腦等移動終端。

  • Swiper能實現觸屏焦點圖、觸屏Tab切換、觸屏多圖切換等常用效果。

  • Swiper開源、免費、穩定、使用簡單、功能強大，是架構移動終端網站的重要選擇。

Swiper的應用場景廣泛，實現效果很好，下面個這實際案例就是Swiper的典型應用場景。

Vue封裝Swiper實現圖片輪播
Swiper的具體使用教程及詳細API，參考Swiper中文網。

二、Vue元件

Vue元件設計初衷就是要配合使用的，提高維護性和複用性。而圖片輪播正適合使用元件來完成，因此在介紹具體的實現之前，先介紹下關於Vue元件及元件通訊。

Vue元件中最常見的就是形成父子元件的關係：元件 A 在它的模板中使用了元件 B。

它們之間必然需要相互通訊：父元件可能要給子元件下發資料，子元件則可能要將它內部發生的事情告知父元件。然而，通過一個良好定義的介面來儘可能將父子元件解耦也是很重要的。這保證了每個元件的程式碼可以在相對隔離的環境中書寫和理解，從而提高了其可維護性和複用性。

在 Vue 中，父子元件的關係可以總結為 prop 向下傳遞，事件向上傳遞。父元件通過 prop 給子元件下發資料，子元件通過事件給父元件傳送訊息。

Vue封裝Swiper實現圖片輪播

三、封裝實現

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 使用分頁導航，詳情見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.效果

Vue封裝Swiper實現圖片輪播

這只是一個簡單的封裝效果，想要實現更多的效果，可以通過Swiper中提供的更多功能來實現。

Github地址： 圖片輪播

相關文章