萬盛學電腦網

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

jQuery bxCarousel 圖片輪播插件配置詳解與實戰示例

插件特性

  • 支持可見項數 display_num、單次滾動項數 move。
  • 自動播放 auto、間隔 auto_interval、方向 auto_dir、懸停暫停 auto_hover。
  • 前後導航按鈕自定義文本/圖片 next_text/prev_text、next_image/prev_image。
  • 項目間距 margin、動畫速度 speed。
  • 無限循環機制:DOM 節點移動而非複製,性能較好。

HTML 結構要求

<ul id="carousel">
  <li><img src="1.jpg" alt="圖片1"></li>
  <li><img src="2.jpg" alt="圖片2"></li>
  <li><img src="3.jpg" alt="圖片3"></li>
  <li><img src="4.jpg" alt="圖片4"></li>
  <li><img src="5.jpg" alt="圖片5"></li>
</ul>

初始化配置詳解

$('#carousel').bxCarousel({
  display_num: 4,        // 可見 4 張
  move: 1,               // 每次滾動 1 張
  speed: 500,            // 動畫 500ms
  margin: 10,            // li 右邊距 10px
  auto: true,            // 自動播放
  auto_interval: 3000,   // 3 秒切換
  auto_dir: 'next',      // 向右
  auto_hover: true,      // 懸停暫停
  next_text: '›',        // 文字箭頭
  prev_text: '‹',
  next_image: '',        // 或圖片 URL
  prev_image: '',
  controls: true         // 顯示箭頭
});

生成的 DOM 結構(供 CSS 定製)

<div class="bx_container">
  <div class="bx_wrap">
    <ul>...原始 li 會被移動...</ul>
    <a class="prev" href="#">‹</a>
    <a class="next" href="#">›</a>
  </div>
</div>

關鍵 CSS 定製

.bx_container { width: 980px; margin: 0 auto; position: relative; }
.bx_wrap { overflow: hidden; position: relative; }
.bx_wrap ul { list-style: none; padding: 0; margin: 0; position: relative; left: 0; }
.bx_wrap li { float: left; margin-right: 10px; text-align: center; } /* margin 與 margin 參數一致 */
.bx_wrap li img { display: block; border: 2px solid #ddd; }
.bx_wrap a.prev, .bx_wrap a.next { 
  position: absolute; top: 50%; transform: translateY(-50%); 
  width: 30px; height: 30px; line-height: 30px; text-align: center; 
  background: rgba(0,0,0,.4); color: #fff; text-decoration: none; border-radius: 50%;
}
.bx_wrap a.prev { left: 10px; }
.bx_wrap a.next { right: 10px; }
.bx_wrap a:hover { background: rgba(0,0,0,.7); }

常見問題與避坑

  • 自動播放不同步:確保 speed < auto_interval,否則動畫未結束就觸發下一次。
  • 無限循環邊界閃爍:插件內部移動節點,CSS 勿對 ul 設置 transition,由 JS animate 控制。
  • 響應式:窗口縮放時需重新計算 display_num、slideWidth 並調用 reload()(插件未暴露,需自行銷毀重建或改用現代響應式輪播庫如 Swiper)。
  • 圖片未加載完寬度為 0:在圖片 onload 後初始化,或預設 li 寬度。

現代替代推薦

  • Swiper:功能最全、響應式、觸摸、虛擬滑動、SSR 友好。
  • Flickity:原生 JS、無依賴、物理拖拽感。
  • tiny-slider:輕量、無依賴、支持懶加載。
copyright © 萬盛學電腦網 all rights reserved