Vue使用Swiper封裝輪播圖組件的方法詳解

更新時(shí)間：2022年09月05日 17:10:28 作者：chyeonL

Swiper是一個(gè)很常用的用于實(shí)現(xiàn)各種滑動(dòng)效果的插件，PC端和移動(dòng)端都能很好的適配。本文將利用Swiper實(shí)現(xiàn)封裝輪播圖組件，感興趣的可以了解一下

Swiper

Swiper是一個(gè)很常用的用于實(shí)現(xiàn)各種滑動(dòng)效果的插件，PC端和移動(dòng)端都能很好的適配。

官網(wǎng)地址：www.swiper.com.cn/

目前最新版本是Swiper7，但眾所周知最新版本通常不穩(wěn)定，所以這里使用Swiper6來(lái)封裝。

Swiper各版本區(qū)別：

為什么要封裝組件

因?yàn)榫W(wǎng)頁(yè)中通常不止一個(gè)地方需要用到輪播圖，所以直接將輪播圖封裝成一個(gè)共用組件，性能會(huì)更好，修改起來(lái)也可以快速找到位置。

開(kāi)始封裝

1.下載安裝Swiper

 npm install Swiper@6            // @6 是指定版本號(hào)為6 的意思
 cnpm install Swiper@6
 yarn add Swiper@6

2.引入css樣式文件

import "swiper/swiper-bundle.min.css";

3.引入js文件

import Swiper from 'swiper/swiper-bundle'

4.把官網(wǎng)使用方法中的HTML結(jié)構(gòu)復(fù)制粘貼過(guò)來(lái)

官網(wǎng)使用方法

注意：

下面不是官網(wǎng)使用文檔的代碼，是我改動(dòng)過(guò)的！
這里的頂層容器類名，不對(duì)應(yīng)的話，后面出大問(wèn)題?。。?/li>

這里官網(wǎng)的使用方法上的容器類名是swiper，對(duì)應(yīng)Swiper7。

但因?yàn)檫@里我下載的是Swiper6，所以我改成了它對(duì)應(yīng)的容器類名swiper-container。

Swiper6及其以前的版本都是對(duì)應(yīng)類名swiper-container

// 注意這里容器的類名?。?
<div class="swiper-container" ref='Carousel'>       
    <div class="swiper-wrapper">
        //v-for循環(huán)生成輪播圖片
        <div class="swiper-slide" v-for="Carousel in list" :key="Carousel.id">
            <img :src="Carousel.imgUrl" />
      </div>
    </div> 

    <!-- 如果需要分頁(yè)器 -->
    <div class="swiper-pagination"></div> 

    <!-- 如果需要導(dǎo)航按鈕 --> 
    <div class="swiper-button-prev"></div> 
    <div class="swiper-button-next"></div> 

    <!-- 如果需要滾動(dòng)條 --> 
    <div class="swiper-scrollbar"></div>
</div>

5.初始化Swiper

初始化時(shí)間：有圖片數(shù)據(jù)后

但是輪播圖的圖片通常都是從后臺(tái)獲取回來(lái)的，需要確定頁(yè)面有數(shù)據(jù)并且DOM結(jié)構(gòu)完全生成后，再初始化。所以最好的方法是： watch監(jiān)聽(tīng) + $nextTick

$nextTick: 將回調(diào)延遲到下次 DOM 更新循環(huán)之后執(zhí)行。在修改數(shù)據(jù)之后立即使用它，然后等待 DOM 更新。

原理：watch監(jiān)聽(tīng)圖片數(shù)據(jù)的變化，$nextTick等到DOM結(jié)構(gòu)完全生成后，立即初始化

watch: {
//list是輪播圖數(shù)據(jù)
    list: {
      immediate: true,   //頁(yè)面初始化的時(shí)候就調(diào)用一次handler()
      handler() {
        this.$nextTick(() => {
          var mySwiper = new Swiper(this.$refs.Carousel, {
            direction: "horizontal", // 水平切換選項(xiàng)
            loop: true, // 循環(huán)模式選項(xiàng)

            // 如果需要分頁(yè)器
            pagination: {
              el: ".swiper-pagination",
              clickable: true,     //可點(diǎn)擊
              type: "bullets",     //默認(rèn)樣式 小圓點(diǎn), 還可選其他形狀
            },

            // 如果需要前進(jìn)后退按鈕
            navigation: {
              nextEl: ".swiper-button-next",
              prevEl: ".swiper-button-prev",
            },
          });
        });
      },
    },
  }

自定義效果

上面的樣式結(jié)構(gòu)是我自定義過(guò)的，不是原本的官方使用文檔，初次使用建議先復(fù)制官網(wǎng)的看看
如果不需要按鈕/分頁(yè)器/滾動(dòng)欄，可以自己在HTML結(jié)構(gòu)和初始化代碼中刪減
如果想要其他的滑動(dòng)效果，可以看看官網(wǎng)其他示例進(jìn)行選擇
如果想要改變具體樣式或者配置，可以看看官方API

完整代碼

封裝的組件名叫Carousel

<template>
  <div class="swiper-container" ref='Carousel'>
    <div class="swiper-wrapper">
      <div class="swiper-slide" v-for="Carousel in list" :key="Carousel.id">
        <img :src="Carousel.imgUrl" />
      </div>
    </div>
    <!-- 如果需要分頁(yè)器 -->
    <div class="swiper-pagination"></div>

    <!-- 如果需要導(dǎo)航按鈕 -->
    <div class="swiper-button-prev"></div>
    <div class="swiper-button-next"></div>
  </div>
</template>

<script>
// 引入swiper的js
import Swiper from "swiper/swiper-bundle.js";
import "swiper/swiper-bundle.min.css";

export default {
  name: "Carousel",
  props: ["list"],
  watch: {
    list: {
      immediate: true,
      handler() {
        this.$nextTick(() => {
          var mySwiper = new Swiper(this.$refs.Carousel, {
            direction: "horizontal", // 垂直切換選項(xiàng)
            loop: true, // 循環(huán)模式選項(xiàng)

            // 如果需要分頁(yè)器
            pagination: {
              el: ".swiper-pagination",
              clickable: true,
              type: "bullets",
            },

            // 如果需要前進(jìn)后退按鈕
            navigation: {
              nextEl: ".swiper-button-next",
              prevEl: ".swiper-button-prev",
            },
          });
        });
      },
    },
  },
};
</script>

<style></style>