前言
最近要開發一個新的「微信活動平台」,手機首頁必須放一張輪播圖。因為已經好一陣子沒有用純手寫的方式做移動端頁面,實在不想重新造一次輪子,於是又回頭去找現成的幻燈片插件。多方比較之後,Swipe 的表現讓我相當滿意,因此特別寫一篇記錄下來,一方面向大家推薦,一方面方便日後查閱。
簡介
Swipe 是一款輕量級的移動端滑動元件,這一點從檔案體積就能看出來。它支援 1:1 的指尖跟手移動、拖曳阻力與邊界回彈,單就移動端的一般需求而言,基本都能滿足。
檔案結構
從 GitHub 下載解壓後會看到總共八個檔案,但真正會進到專案裡的,基本上只有 swipe.js 這一支。index.html 與 style.css 只是示範用的,有興趣可以研究它們如何組織結構與樣式。
最小可用範例
用法非常直覺,下面這段程式碼就能跑起來:
<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<title>演示</title>
<!-- 首先引入JQuery -->
<script src="https://apps.bdimg.com/libs/jquery/2.1.1/jquery.min.js"></script>
<!-- 引入核心swipe.js文件 -->
<script src="swipe.js"></script>
<!-- 幻燈片基礎樣式 -->
<style>
.swipe { overflow: hidden; visibility: hidden; position: relative; }
.swipe-wrap { overflow: hidden; position: relative; }
.swipe-wrap > div {
float:left;
width:100%;
position: relative;
font-size:140px; /* 這裡樣式是為了演示方便,我特意加的 */
}
</style>
</head>
<body>
<!-- 幻燈片實例代碼,前兩層是外圍容器 -->
<div id='slider' class='swipe'>
<div class='swipe-wrap'>
<!-- 這三個是幻燈片內容,其中1,2,3等數字可換成圖片 -->
<div>1</div>
<div>2</div>
<div>3</div>
</div>
</div>
<!-- 頁面幻燈片運行腳本(初始化) -->
<script>
window.mySwipe = Swipe(document.getElementById('slider'));
</script>
</body>
</html>
用滑鼠拖曳,或直接在手機上滑動,就能看到切換效果。當然,這只是最基礎的形態,全部採用預設值。真正的價值在於它可以透過參數自訂,做出符合設計稿的行為。
可傳入的參數
startSlide Integer (default:0) — 起始索引位置,指定從第幾張開始顯示,預設 0。
speed Integer (default:300) — 切換動畫的毫秒數,預設 300。
auto Integer — 自動播放的間隔毫秒數。
continuous Boolean (default:true) — 是否循環播放,讓首尾相接沒有終點,預設 true。
disableScroll Boolean (default:false) — 是否鎖住該容器上的頁面滾動,預設 false。
stopPropagation Boolean (default:false) — 是否阻止事件冒泡,預設 false。
callback Function — 每次切換時觸發的回呼函式。
transitionEnd Function — 動畫結束時觸發的函式。
官方的示範寫法如下:
window.mySwipe = new Swipe(document.getElementById('slider'), {
startSlide: 2,
speed: 400,
auto: 3000,
continuous: true,
disableScroll: false,
stopPropagation: false,
callback: function(index, elem) {},
transitionEnd: function(index, elem) {}
});
參數的位置與用法一目了然:它們全部以 JSON 物件的形式,作為 Swipe 的第二個參數傳入,你可以依需求自行增減。
常用 API
prev() — 切到上一張。
next() — 切到下一張。
getPos() — 取得目前的索引位置。
getNumSlides() — 取得總張數。
slide(index, duration) — 跳到指定索引,duration 為動畫毫秒數。
這些介面都很單純,用 JavaScript 呼叫它們,就能搭配自訂的左右箭頭、圓點指示器或自動播放開關,組出完整的輪播體驗。
專案網址:https://github.com/thebird/swipe/