jCarousel Lite 是輕量級 jQuery 輪播插件,支援水平/垂直、自動播放、循環、分頁按鈕、緩動效果等,壓縮後僅約 2KB,適合行動裝置與極速載入需求。
| 參數 | 型別 | 預設 | 說明 |
|---|---|---|---|
| btnPrev | String | null | 上一頁按鈕選擇器,如 '.prev' |
| btnNext | String | null | 下一頁按鈕選擇器,如 '.next' |
| btnGo | Array | null | 直接跳轉按鈕陣列,如 ['.1', '.2'] 對應第 1、2 項 |
| mouseWheel | Boolean | false | 是否支援滑鼠滾輪控制 |
| auto | Number | null | 自動播放間隔(毫秒),如 1000 為 1 秒 |
| speed | Number | 200 | 滑動動畫持續時間(毫秒),0 為無動畫 |
| easing | String | 'swing' | 緩動函數名稱,需引入 jQuery Easing Plugin |
| vertical | Boolean | false | 垂直滾動模式 |
| circular | Boolean | true | 是否循環滾動,false 時到頭停止 |
| visible | Number | 3 | 可見項目數,支援小數(如 2.5 顯示 2.5 項) |
| start | Number | 0 | 初始顯示索引 |
| scroll | Number | 1 | 每次滾動項目數 |
| beforeStart | Function | null | 滾動開始前回呼,接收目標元素參數 |
| afterEnd | Function | null | 滾動結束後回呼,接收目標元素參數 |
<ul id="carousel">
<li><img src="1.jpg"></li> <li><img src="2.jpg"></li> ...
</ul>
<a class="prev">上一頁</a> <a class="next">下一頁</a>
<script>
$('#carousel').jCarouselLite({
btnPrev: '.prev',
btnNext: '.next',
auto: 3000,
speed: 800,
visible: 3,
circular: true,
afterEnd: function(el) { console.log('停留在:', el); }
});
</script>
visible 必須與 CSS 寬度配合(li 寬度 × 可見數 = 容器寬度)。easing 需額外載入 jquery.easing.js,否則僅支援 linear/swing。.jCarouselLite('reload') 或重新初始化。