萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 輪播插件 jCarousel Lite 參數中文完整說明

插件簡介

jCarousel Lite 是輕量級 jQuery 輪播插件,支援水平/垂直、自動播放、循環、分頁按鈕、緩動效果等,壓縮後僅約 2KB,適合行動裝置與極速載入需求。

參數對照表

參數型別預設說明
btnPrevStringnull上一頁按鈕選擇器,如 '.prev'
btnNextStringnull下一頁按鈕選擇器,如 '.next'
btnGoArraynull直接跳轉按鈕陣列,如 ['.1', '.2'] 對應第 1、2 項
mouseWheelBooleanfalse是否支援滑鼠滾輪控制
autoNumbernull自動播放間隔(毫秒),如 1000 為 1 秒
speedNumber200滑動動畫持續時間(毫秒),0 為無動畫
easingString'swing'緩動函數名稱,需引入 jQuery Easing Plugin
verticalBooleanfalse垂直滾動模式
circularBooleantrue是否循環滾動,false 時到頭停止
visibleNumber3可見項目數,支援小數(如 2.5 顯示 2.5 項)
startNumber0初始顯示索引
scrollNumber1每次滾動項目數
beforeStartFunctionnull滾動開始前回呼,接收目標元素參數
afterEndFunctionnull滾動結束後回呼,接收目標元素參數

基本使用範例

<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') 或重新初始化。
copyright © 萬盛學電腦網 all rights reserved