# 组件文档说明 ## 下载依赖 ### npm install vue-awesome-swiper --save ### npm install swiper@5.3.6 --save ## options设置 ### 1 切换效果 fade cube coverflow flip effect: 'flip', 样式设定 fadeEffect: { 淡出fade crossFade: true, 方块切换 cube slideShadows: true, shadow: true, shadowOffset: 100, shadowScale: 0.6, coverflow slidesPerView: 3, centeredSlides: true, coverflowEffect: { rotate: 30, stretch: 10, depth: 60, modifier: 2, slideShadows: true, }, flip slideShadows: true, limitRotation: true, }, ### 2 不可拖动文字 noSwiping: true, ### 3 当你的Swiper在过渡时将无法滑动 preventInteractionOnTransition : true, 短切换,长切花 shortSwipes: false, 自由滑动,不知道滑过几个 freeMode: true, ### 4 设置预览值 px slidesOffsetBefore: 100, 显示多行 slidesPerView: 3, //一行显示3个 slidesPerColumn: 2, //显示2行 ### 5 一页显示三个,一组为三个 slidesPerView: 3, slidesPerGroup: 3, ### 6 slidesPerView: 2, //slidesPerView : 'auto', 根据slide的宽度自动调整展示数量。此时需要设置slide的宽度,如下style所示 //slidesPerView : 3.7, ### 7 默认居中,并一页显示三个,第一条在左侧 slidesPerView: 3, centeredSlides: true, centeredSlidesBounds: true, ### 8 默认居中,并一页显示三个,第一个在中间 slidesPerView: 3, centeredSlides: true, ### 9 如果有一个数据时,所有分页,按钮,分页点全部失效 watchOverflow: true, ### 10 滑过触发回调 runCallbacksOnInit: true, on: { slideChangeTransitionStart: function() { 选中值 console.log(this.activeIndex); }, }, ### 11 自适应高度 随silde变化而变化 autoHeight: true, ### 12 默认一页显示数 slidesPerView: 4, 数据间隔 px spaceBetween: 30, 不同屏幕配置 breakpoints: { 320: { //当屏幕宽度大于等于320 slidesPerView: 2, spaceBetween: 10, }, 768: { //当屏幕宽度大于等于768 slidesPerView: 3, spaceBetween: 20, }, 1280: { //当屏幕宽度大于等于1280 slidesPerView: 4, spaceBetween: 30, }, }, ### 13 鼠标滑过显示小手 grabCursor: true, ### 14 自动滑过贴合时间 speed: 300, autoplay: { 默认3秒切换一次 delay: 3000, 到最后一个自动停止 stopOnLastSlide: true, 触碰当前页自动停止 disableOnInteraction: true, 反向自动轮播 reverseDirection: true, }, ### 15 自动滑过 autoplay: true, //鼠标覆盖停止自动切换 ### 16 默认索引值,0:开始 initialSlide: 0, ### 17 垂直切换选项 direction: 'vertical', ### 18 循环轮播 loop: true, ### 19 分页 pagination: { el: '.swiper-pagination', clickable为true时,点击小点控制轮播 clickable: true, 分页类型 type: 'bullets',//点 type: 'fraction',//数字 type: 'progressbar',//上条 type: 'custom', //自定义 progressbarOpposite: true,//progressbar-左条 bulletElement: 'li',//指定标签 dynamicBullets: true,//bullets-点数过多,隐藏 dynamicMainBullets: 4,//显示点数量 hideOnClick: true,//点击数据时,隐藏分页 自定义点样式 renderBullet: function(index, className) { return '' + (index + 1) + ''; }, 设置分式 type: 'fraction', renderFraction: function(currentClass, totalClass) { return '' + ' of ' + ''; }, 自定义点样式 type: 'custom', renderCustom: function(swiper, current, total) { return current + ' of ' + total; }, bulletClass: 'my-bullet', //需设置.my-bullet样式 bulletActiveClass: 'my-bullet-active', //需设置my-bullet-active样式 }, ### 20 按钮导航 navigation: { nextEl: '.swiper-button-next', prevEl: '.swiper-button-prev', },