插件特性
- 支持可見項數
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 寬度。
現代替代推薦