行動版網站的首屏幾乎一定會有輪播圖(carousel)。桌機靠左右箭頭點擊,手機則直覺得多——使用者會直接用手指滑。本文記錄一個以 Zepto 為基礎的輕量輪播元件,支援觸控滑動切換,並附完整用法與 API 說明。

最簡單的方式是依序載入 zepto 與 carousel-image,再初始化:
<script type="text/javascript" src="../src/zepto.js"></script>
<script type="text/javascript" src="../src/carousel-image.js"></script>
<script>
$('.carousel-image').CarouselImage({ num: $('.carousel-num') });
</script>
若專案使用 AMD 模組化,寫法如下:
<div class="carousel-image">
<div>
<a><img src="https://www.yoursiteweb.com/images/1430073193462.jpg"/></a>
<a><img src="https://www.yoursiteweb.com/images/1430073252953.png"/></a>
<a><img src="https://www.yoursiteweb.com/images/1430073111420.jpg"/></a>
</div>
<div class="carousel-num"></div>
</div>
<script type="text/javascript" src="../src/zepto.js"></script>
<script type="text/javascript" src="../src/require.js"></script>
<script>
requirejs.config({
// 預設從 js/lib 載入模組
baseUrl: '../src',
paths: { $: 'zepto' }
});
require(['carousel-image', "$"], function (CarouselImage, $) {
var cs = new CarouselImage();
cs.init({ target: $('.carousel-image'), num: $('.carousel-num') });
});
</script>
事件要在哪個容器內觸發就打哪個容器。建議這個容器底下再包一層子容器作為滑動軌道,動畫會更順、也更容易做位移最佳化。
原本設計是用來顯示「目前是第幾張」的數字指示器。範例中把數字以 CSS 隱藏起來了,若你想改成圓點或其他樣式,直接改樣式檔即可,不必動 JS。
這個元件的優點是體積小、依賴少(只需要 Zepto),很適合放在流量大的 H5 活動頁。缺點是沒有自動播放、無限循環等進階設定,若需要這些功能,可以考慮 Swiper 這類成熟方案。