輪播圖是首頁的常見元素。這個實作以 jQuery 的 animate() 為核心,透過點擊左右箭頭讓整排項目滑動一個寬度,並在抵達頭尾時回到另一端,形成無限循環的效果。
$(function () {
var index = 1; // 當前頁(預留擴充用)
var pPage = 1; // 目前所在頁碼
var $v_citemss = $(".citemss"); // 輪播容器
var $v_show = $v_citemss.find("ul"); // 真正移動的 ul
var v_width = $v_citemss.width(); // 每次滑動的距離 = 容器寬度
var p_count = $v_citemss.find("li").length; // 項目總數
// 上一頁
$(".slideprev1").click(function () {
if (!$v_show.is(":animated")) { // 動畫進行中不接受新點擊
if (pPage == index) {
// 已在第一頁:先滑回起始位置,再跳到最後一頁
$v_show.animate({ right: '0px' }, "3000");
pPage = 4;
} else {
$v_show.animate({ right: '-=' + v_width }, "3000");
pPage--;
}
}
});
// 下一頁
$(".slidenext").click(function () {
if (!$v_show.is(":animated")) {
if (pPage == p_count) {
// 已在最後一頁:回到起始位置
$v_show.animate({ left: '0px' }, "3000");
pPage = 1;
} else {
$v_show.animate({ left: '-=' + v_width }, "3000");
pPage++;
}
}
});
});
用 -= 做累加位移。animate({ left: '-=' + v_width }) 表示「在目前位置的基礎上再往左移動一個容器寬度」,不必手動計算絕對座標,程式碼簡單且不易出錯。
用 :animated 做動畫鎖。動畫進行中若使用者連點,會導致位移錯亂。加上 if (!$v_show.is(":animated")) 判斷,就能把連續點擊忽略掉。這是一個實務上很重要的小細節。
変數宣告位置。原範例註解中提醒:若 v_width 前面再加 var 會出問題。實際原因是範例中它與 p_count 寫在同一個 var 宣告群之後卻沒有逗號分隔,補上 var 會造成語法錯誤。正確做法是在函式頂端一次宣告:var v_width = ..., p_count = ...;
硬編碼的頁數。pPage = 4 這一行把項目數量寫死了。若日後增減圖片數量,這裡必須同步修改。更好的寫法是直接用 pPage = p_count,讓程式自動跟隨資料變化。
關於「滑鼠移入時下方浮出描述條、左右浮現箭頭」這類效果,其實完全不需要 JavaScript,純 CSS 就能做到,而且效能更好:
.slide {
position: relative;
overflow: hidden;
}
.slide .desc,
.slide .prev,
.slide .next {
position: absolute;
opacity: 0;
transition: all .3s ease;
}
.slide .desc { left: 0; bottom: -40px; } /* 藏在下方 */
.slide .prev { left: -50px; } /* 藏在左側 */
.slide .next { right: -50px; } /* 藏在右側 */
.slide:hover .desc { bottom: 0; opacity: 1; }
.slide:hover .prev { left: 10px; opacity: 1; }
.slide:hover .next { right: 10px; opacity: 1; }
原理是把元素絕對定位到容器邊界之外(bottom 或 left/right 為負值),滑鼠移入時改回正確位置,再用 transition 作為動畫緩衝。這比在 JS 裡監聽 mouseenter/mouseleave 再改 style 簡潔得多,也不會有事件漏綁或記憶體洩漏的風險。
動畫時長。範例中的 "3000" 是 3 秒,對輪播來說偏慢,實務上 300–500 毫秒的手感通常更好。
加入自動播放與暫停。搭配 setInterval 自動前進,並在 mouseenter 時 clearInterval 暫停、mouseleave 時恢復,是輪播的基本配備。
無障礙考量。左右箭頭若是圖片或空字串連結,務必加上 aria-label="上一張";輪播區塊可加上 aria-roledescription="carousel";並尊重系統的「減少動態效果」偏好:@media (prefers-reduced-motion: reduce) { transition: none; }。另外,自動播放的輪播需提供暫停控制,否則對部分使用者會造成困擾。
現代替代方案。若不打算維護自家程式碼,CSS Scroll Snap 搭配 overflow-x: auto 可以用不到十行 CSS 做出原生等級的滑動體驗,還免費附贈觸屏手勢支援:
.track {
display: flex;
overflow-x: auto;
scroll-snap-type: x mandatory;
}
.track > * { scroll-snap-align: start; flex: 0 0 100%; }