Vue-Awesome-Swiper
轮播图插件,可以同时支持Vue.js(1.X ~ 2.X),兼顾PC和移动端,SPA和SSR。
例子:https://surmon-china.github.io/vue-awesome-swiper
npm install vue-awesome-swiper--save
//importimportVue from'vue'importVueAwesomeSwiper from'vue-awesome-swiper'//orrequirevarVue =require('vue')varVueAwesomeSwiper =require('vue-awesome-swiper')//mountwithglobalVue.use(VueAwesomeSwiper)//If usedinNuxt.js/SSR, you should keep it onlyinbrowser build environment//The `Process. BROWSER_BUILD` itselfisjust a feature, itisonly validinNuxt.js, you need to modify it according to your own procedures, suchas:invue official ssr scaffolding it should be` process.browser`if(process.BROWSER_BUILD) {constVueAwesomeSwiper =require('vue-awesome-swiper/ssr') Vue.use(VueAwesomeSwiper)}//mountwithcomponent(can't work in Nuxt.js/SSR)
import { swiper, swiperSlide } from 'vue-awesome-swiper'
export default {
components: {
swiper,
swiperSlide
}
}
SPA通过组件作用,需要借助ref属性查找swiper实例
SSR通过命令作用,需要借助命令参数查找swiper实例
其他配置和事件一致
<!-- You can custom the "mySwiper" name used to find the swiper instance in current component -->exportdefault{ data () {return{ banners: ['/1.jpg','/2.jpg','/3.jpg'], swiperOption: { autoplay:5000, initialSlide:1, loop:true, pagination:'.swiper-pagination', onSlideChangeEnd: swiper => { console.log('onSlideChangeEnd', swiper.realIndex) } } } }, mounted() { console.log('app init') setTimeout(() => {this.banners.push('/5.jpg') console.log('banners update') },3000) console.log('This is current swiper instance object',this.mySwiper,'It will slideTo banners 3')this.mySwiper.slideTo(3) } }
<!-- The ref attr used to find the swiper instance --><!-- slides -->I'm Slide 1I'm Slide 2I'm Slide 3I'm Slide 4I'm Slide 5I'm Slide 6I'm Slide 7<!-- Optional controls -->// swiper options example:exportdefault{ name:'carrousel', data() {return{ swiperOption: {// NotNextTick is a component's own property, and if notNextTick is set to true, the component will not instantiate the swiper through NextTick, which means you can get the swiper object the first time (if you need to use the get swiper object to do what Things, then this property must be true)// notNextTick是一个组件自有属性,如果notNextTick设置为true,组件则不会通过NextTick来实例化swiper,也就意味着你可以在第一时间获取到swiper对象,假如你需要刚加载遍使用获取swiper对象来做什么事,那么这个属性一定要是truenotNextTick:true,// swiper configs 所有的配置同swiper官方api配置autoplay:3000, direction :'vertical', grabCursor :true, setWrapperSize :true, autoHeight:true, pagination :'.swiper-pagination', paginationClickable :true, prevButton:'.swiper-button-prev', nextButton:'.swiper-button-next', scrollbar:'.swiper-scrollbar', mousewheelControl :true, observeParents:true,// if you need use plugins in the swiper, you can config in here like this// 如果自行设计了插件,那么插件的一些配置相关参数,也应该出现在这个对象中,如下debuggerdebugger:true,// swiper callbacks// swiper的各种回调函数也可以出现在这个对象中,和swiper官方一样onTransitionStart(swiper){ console.log(swiper) },// more Swiper configs and callbacks...// ...} } },// you can find current swiper instance object like this, while the notNextTick property value must be true// 如果你需要得到当前的swiper对象来做一些事情,你可以像下面这样定义一个方法属性来获取当前的swiper对象,同时notNextTick必须为truecomputed: { swiper() {returnthis.$refs.mySwiper.swiper } }, mounted() {// you can use current swiper instance object to do something(swiper methods)// 然后你就可以使用当前上下文内的swiper对象去做你想做的事了console.log('this is current swiper instance object',this.swiper)this.swiper.slideTo(3,1000,false) } }
I'm Slide{{slide}}exportdefault{ name:'carrousel', data() {return{ swiperOption: { autoplay:3500, setWrapperSize :true, pagination :'.swiper-pagination', paginationClickable :true, mousewheelControl :true, observeParents:true, }, swiperSlides: [1,2,3,4,5] } }, mounted() { setInterval(() => { console.log('simulate async data')letswiperSlides =this.swiperSlidesif(swiperSlides.length
移动端例子的代码
例子:https://github.com/surmon-china/vue-awesome-swiper/blob/master/examples/41-mobile-fullpage-example.vue
SSR例子的代码
例子:https://github.com/surmon-china/vue-awesome-swiper/blob/master/nuxt-ssr-example
API
参考官网:
http://www.swiper.com.cn/api/index.html
https://github.com/surmon-china/vue-awesome-swiper/blob/master/nuxt-ssr-example
我自己的前端学习交流群562862926,收集的一套前端教学视频,全段学习路线分享给大家