偶遇vue-awesome-swiper的坑

Posted 2020-10-29 新哥·lewis

最近用vue重构一个移动端的项目，碰到了不少坑，今天拿移动端最著名的轮播插件swiper为例来说，由于这个项目没用UI库，纯手写的样式，沿用老的插件，自然而然的选择了vue-awesome-swiper(3.1.3)最新版，记不清上次用这个插件多久了，现在用来竟遇到很多坑，今晚闲暇以此记录，帮助大家避免踩坑。

1. 轮播图不轮播

这个原因有很多，首先要检查样式swiper.css是否正确的引进来了，其次是最容易被忽略的也是这次最主要的原因，最新版的vue-awesome-swiper是基于swiper4，有很多配置option已经变了，最为明显的就是原来的key-value格式autoplay: true,现在已经变成了下面这样的json格式：

autoplay:{
    enabled: true,
    disableOnInteraction: false,
    delay: 3000
},
pagination: {
    el: ‘.pagination‘
}

下图为证：

官网上的图
配置好以后应该是可以轮播了，还有就是SPA如果不是多个轮播的话没必要全局引这个，

 

import VueAwesomeSwiper from ‘vue-awesome-swiper‘;
import ‘swiper/dist/css/swiper.css‘;
Vue.use(VueAwesomeSwiper);

只需要在封装好的轮播组件内引入以下这个就够了。

import { swiper, swiperSlide } from ‘vue-awesome-swiper‘;
import ‘swiper/dist/css/swiper.css‘

2. 分页器pagination没出现

这个的话其一就是因为上面提到的配置option格式变了，其二是需要在pagination 的div盒子里增加slot="pagination"用来分发，这两个都没问题的话应该就OK了。

3. 轮播第二次开始后第一张图一闪而过

这个问题困扰了我好久，百度了很久也没找到有用的线索，今天早上去了公司心里想这个问题必须解决啊，要不体验也太差了，所以直接Google一下吧，第一个答案就是vue-awesome-swiper的GitHub上的issue，一看原来早已有人遇到了类似的问题，作者给出的解释是由于vue特殊的渲染机制导致数据没有完全返回时swiper已经初始化了，现在解决的方法是加v-if=“data.length”,保证数据完全返回了才开始渲染swiper，这样总算是解决了，体验马上好极啦！之前由于英文不好所以一般有问题都是百度，最近发现同事有问题都是Google，今日一试果然是快准狠，以后要充分的利用好Google和StackOverFlow，提升效率不是一点半点哈！

4. resize()方法报错undefined

这个问题也是因为swiper4已经把resize变为一个object，它包含两个方法，我用了它的resizeHandler()方法，这样就OK了。

技术在不断进步，插件在不断更新，以后遇到问题一定要先看原文档，解决问题多借助Google！