做網站首頁時常會遇到這樣的需求:公告太多,版面只放得下一兩條,於是希望它們能自動循環輪播,旁邊再配上「上一條/暫停/下一條」三顆小按鈕。這篇記錄的就是我在專案裡實際用 jCarouselLite 外掛完成這個功能的过程。
頁面結構
公告區分成兩半:左邊是控制鈕,右邊是承載公告清單的容器。這裡有個關鍵細節——清單的 id="dt_gg" 一開始必須是 display:none,等 JavaScript 確認要啟用輪播之後才顯示出來。這樣做的用意是避免「只有一筆資料卻還在跑動畫」的突兀感,同時在 JS 掛掉時至少有個合理的降級。
. 代碼如下:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=GBK" />
<meta http-equiv="X-UA-Compatible" content="IE=7" />
<title>test</title>
<script type="text/javascript" src="jquery-1.2.6.pack.js"></script>
<style>
.banner_index { float:left; width:730px; height:239px; overflow:hidden; margin:5px 0 0 0;}
.banner_index_pic { width:730px; height:239px; overflow:hidden;}
</style>
</head>
<body scroll="yes">
<script type="text/javascript" src="jcarousellite_1.0.1.js"></script>
<div class="gg">
<li class="gg_btn">
<img src="pre_btn.jpg" border="0" id="gg_p" style="cursor: pointer;" title="上一條"/>
<img src="break_btn.jpg" border="0" id="gg_s" style="cursor: pointer;" title="暫停"/>
<img src="next_btn.jpg" border="0" id="gg_n" style="cursor: pointer;" title="下一條"/>
</li>
<li class="gg_info">
<a class="aa" style="cursor:hand" href="/notice/"><b>網廳公告:</b></a>
<div id="dt_gg" style="display: none; float: left; width: 450px;">
<ul style="height:25px;overflow:hidden;">
<li style="width: 300px">
<a class="aa" href="/cms/web/default/new/notice/50514.shtml" title="關於調整全省固定電話本地電話網營業區間通話費上限標准的通知"><span>關於調整全省固定電話本地電話網</span></a>
<span style="width:100px;">[2010-06-24]</span>
</li>
<li style="width: 300px">
<a class="aa" href="/cms/web/default/new/notice/50515.shtml" title="中國電信機場/車站貴賓服務電子化認證公告"><span>中國電信機場/車站貴賓服務電子</span></a>
<span style="width:100px;">[2010-06-24]</span>
</li>
</ul>
</div>
</li>
</div>
<script type="text/javascript">
jQuery(function(){
jQuery('#dt_gg').css("display","block");
if(jQuery('#dt_gg').find('li').length > 1){
jQuery('#dt_gg').jCarouselLite({
btnPrev:'#gg_n',
btnNext:'#gg_p',
btnAutoSwitch:'#gg_s',
visible: 1,
auto:5000,
speed:1000,
onMouse:true,
vertical:true
});
}else{
jQuery('#dt_gg').jCarouselLite({ visible: 1 });
}
});
jQuery(function(){
jQuery('#gg_s').click(function(){
if(jQuery(this).attr('src') == "/cms/web/images/V3/public/break_btn.jpg"){
jQuery(this).attr('src','/cms/web/images/V3/public/play_btn.jpg');
jQuery(this).attr('title','播放');
}else{
jQuery(this).attr('src','/cms/web/images/V3/public/break_btn.jpg');
jQuery(this).attr('title','暫停');
}
});
});
</script>
參數怎麼解讀
visible: 1 表示一次只顯示一筆;auto: 5000 是每 5 秒自動切換;speed: 1000 是切換動畫耗時 1 秒;vertical: true 讓它變成上下捲動而不是左右滑動;onMouse: true 則讓滑鼠移入時暫停,方便使用者點擊連結。
要留意的是這份範例裡 btnPrev 對應的是 #gg_n(下一條的圖)、btnNext 對應 #gg_p(上一條的圖),兩者是對調的。這通常不是 bug,而是因為 vertical 模式下視覺方向顛倒所致,實作時請依實際效果調整,不要照抄。
可以更好的地方
這份程式寫在 jQuery 1.2.6 的年代,以今天的角度來看有幾處該改:暫停鈕用「比對 src 路徑」來判斷狀態很脆弱,圖片一改名就壞,建議改用 .toggleClass() 或自訂 data- 屬性記錄狀態;另外 <li> 直接放在 <div> 裡面並不合 HTML 規範,應該包進 <ul>。若今天重寫,我會直接改用 Slick 或 Swiper 這類仍在維護的輪播庫。