vue-awesome-swiper的API整理


參數 類型(swiper3) 默認值(swiper3) 類型(swiper4) 默認值(swiper4) 說明
autoplay Number/Boolean 0/false Object autoplay 自動切換
speed Number 300 Number 300 切換速度
loop Boolean false Boolean false loop模式
loopAdditionalSlides Number 0 Number 0 loop模式下會在slides前后復制若干個slide,,前后復制的個數不會大於原總個數。
loopedSlides Number 1 Number 1 在loop模式下使用slidesPerview:'auto',還需使用該參數設置所要用到的loop個數。
direction String horizontal String horizontal Slides的滑動方向
autoplayDisableOnInteraction Boolean true - - 用戶操作swiper之后,是否禁止autoplay
autoplayStopOnLast Boolean true - - 切換到最后一個slide時停止自動切換
grabCursor Boolean false Boolean false 鼠標覆蓋Swiper時指針會變成手掌形狀,拖動時指針會變成抓手形狀
width Number - Number - 強制Swiper的寬度
height Number - Number - 強制Swiper的高度
autoHeight Boolean false Boolean false 自動高度
freeMode:         swiper3/4 api相同
freeMode Boolean false - - free模式,slide會根據慣性滑動且不會貼合
freeModeMomentum Boolean true - - free模式動量。若設置為false則關閉動量,釋放slide之后立即停止不會滑動。
freeModeMomentumRatio Number 1 - - free模式動量值(移動慣量)
freeModeMomentumVelocityRatio Number 1 - - 動量反彈
freeModeMomentumBounce Boolean true - - Slides的滑動方向
freeModeMomentumBounceRatio Number 1 - - 值越大產生的邊界反彈效果越明顯,反彈距離越大。
freeModeSticky Boolean false - - 使得freeMode也能自動貼合。
effect:         swiper3/4 api相同
effect String slide - - slide的切換效果。
fade/fadeEffect(4) Object fade - - fade效果參數。
cube/cubeEffect Object cube - - cube效果參數。
coverflow/coverflowEffect Object coverflow - - coverflow效果參數。
flip/flipEffect Object flip - - flip效果參數。
Zoom:          
zoom Boolean false Object zoom 焦距功能:雙擊slide會放大,並且在手機端可雙指觸摸縮放。
zoomMax Number 3 - - 最大縮放焦距(放大倍率).
zoomMin Number 1 - - 最小縮放焦距(縮小倍率)。
zoomToggle Boolean true - - 設置為false,不允許雙擊縮放,只允許手機端觸摸縮放。
pagination:          
pagination String - Object pagination 分頁器容器的css選擇器或HTML標簽
paginationType String - - - bullets’ 圓點(默認)‘fraction’ 分式 ‘progress’ 進度條‘custom’ 自定義
paginationClickable Boolean false - - 點擊分頁器的指示點分頁器控制Swiper切換
paginationHide Boolean false - - 默認分頁器會一直顯示
paginationElement String span - - 設定分頁器指示器(小點)的HTML標簽。
Navigation Buttons:       swiper4 navigation  
nextButton string / HTMLElement - - - 前進按鈕的css選擇器或HTML元素。
prevtButton string / HTMLElement - - - 后退按鈕的css選擇器或HTML元素。
Scrollbar:          
scrollbar string / HTMLElement - Object swiper4 Scrollbar Scrollbar容器的css選擇器或HTML元素
scrollbarHide Bolean true - - 滾動條是否自動隱藏。
scrollbarDraggable Boolean false - - 該參數設置為true時允許拖動滾動條。
scrollbarSnapOnRelease Boolean false - - 如果設置為true,釋放滾動條時slide自動貼合。

autoplay:

autoplay: {
   delay: 3000, // 自動切換的時間間隔,單位ms
   stopOnLastSlide: false, // 當切換到最后一個slide時停止自動切換
   stopOnLastSlide: true, // 如果設置為true,當切換到最后一個slide時停止自動切換。
   disableOnInteraction: true, // 用戶操作swiper之后,是否禁止autoplay。
   reverseDirection: true, // 開啟反向自動輪播。
   waitForTransition: true // 等待過渡完畢。自動切換會在slide過渡完畢后才開始計時。
 },

fade:

fadeEffect: {
   crossFade: false
 }

cube:

cubeEffect: {
   slideShadows: true, // 開啟slide陰影。默認 true。
   shadow: true, // 開啟投影。默認 true。
   shadowOffset: 100, // 投影距離。默認 20,單位px。
   shadowScale: 0.6 // 投影縮放比例。默認0.94。
 },

coverflow:

coverflowEffect: {
   rotate: 30, // slide做3d旋轉時Y軸的旋轉角度。默認50。
   stretch: 10, // 每個slide之間的拉伸值,越大slide靠得越緊。 默認0。
   depth: 60, // slide的位置深度。值越大z軸距離越遠,看起來越小。 默認100。
   modifier: 2, // depth和rotate和stretch的倍率,相當於depth*modifier、rotate*modifier、stretch*modifier,值越大這三個參數的效果越明顯。默認1。
   slideShadows : true // 開啟slide陰影。默認 true。
 },

flip:

flipEffect: {
   slideShadows : true, // slides的陰影。默認true。
   limitRotation : true // 限制最大旋轉角度為180度,默認true。
 }

zoom:

zoom: {
   maxRatio: 5, // 最大倍數
   minRatio: 2, // 最小倍數
   toggle: false, // 不允許雙擊縮放,只允許手機端觸摸縮放。
   containerClass: 'my-zoom-container' // zoom container 類名
 },

pagination:

pagination: {
   el: '.swiper-pagination',
   type: 'bullets',
   // type: 'fraction',
   // type : 'progressbar',
   // type : 'custom',
   progressbarOpposite: true, // 使進度條分頁器與Swiper的direction參數相反
   bulletElement : 'li', // 設定分頁器指示器(小點)的HTML標簽。
   dynamicBullets: true,  // 動態分頁器,當你的slide很多時,開啟后,分頁器小點的數量會部分隱藏。
   dynamicMainBullets: 2, // 動態分頁器的主指示點的數量
   hideOnClick: true, // 默認分頁器會一直顯示。這個選項設置為true時點擊Swiper會隱藏/顯示分頁器。
   clickable: true // 此參數設置為true時,點擊分頁器的指示點分頁器會控制Swiper切換。
 },

navigation:

navigation: {
   nextEl: '.swiper-button-next', // 前進按鈕的css選擇器或HTML元素。
   prevEl: '.swiper-button-prev', // 后退按鈕的css選擇器或HTML元素。
   hideOnClick: true, // 點擊slide時顯示/隱藏按鈕
   disabledClass: 'my-button-disabled', // 前進后退按鈕不可用時的類名。
   hiddenClass: 'my-button-hidden' // 按鈕隱藏時的Class
 },

Scrollbar:

scrollbar: {
   el: '.swiper-scrollbar',
   hide: true, // 滾動條是否自動隱藏。默認:false,不會自動隱藏。
   draggable: true, // 該參數設置為true時允許拖動滾動條。
   snapOnRelease: true, // 如果設置為false,釋放滾動條時slide不會自動貼合。
   dragSize: 30 // 設置滾動條指示的尺寸。默認'auto': 自動,或者設置num(px)。
 },

  


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM