Cycle 是 jQuery 早期最受歡迎的輪播外掛之一,最大的優點是「一行就能跑」:它不要求特定的 HTML 結構,任何一群同層級的兄弟元素都能被變成幻燈片。這篇從最簡單的用法一路寫到特效設定。
第一步:引入檔案
順序很重要——jQuery 必須排在 Cycle 之前,否則會拿到「$ is not defined」。
. 代碼如下:
<head>
<script type="text/javascript" src="js/jquery-1.8.0.min.js"></script>
<script type="text/javascript" src="js/jquery.cycle.all.js"></script>
<link href="style.css" rel="stylesheet" type="text/css" >
</head>
第二步:寫 HTML
用 <ul> 包一組商品資料,每個 <li> 就是一張投影片。
. 代碼如下:
<ul id="goods">
<li>
<img src="img/lenovopad.jpg" alt="lenove pad" />
<div class="title">聯想 A3000(8GB/白色)</div>
<div class="author">娛樂平板電腦</div>
</li>
<li>
<img src="img/note3.jpg" alt="note3" />
<div class="title">三星 GALAXY Note III</div>
<div class="author">5.7 吋 Super AMOLED 全高清螢幕</div>
</li>
<li>
<img src="img/ipadair.png" alt="ipadair" />
<div class="title">iPad Air</div>
<div class="author">纖薄輕巧,體積比上一代減小近四分之一</div>
</li>
</ul>
第三步:上樣式
輪播要正常運作,容器必須有明確的寬高並 overflow:hidden,每個 <li> 則要靠 position: relative 成為定位上下文。
. 代碼如下:
html, body { margin: 0; padding: 0; }
body { font: 62.5% Verdana, Helvetica, Arial, sans-serif; color: #000; background: #fff; }
ul#goods { list-style: none; margin: 0; padding: 0; height: 210px; width: 500px; overflow: hidden; }
ul#goods li { list-style: none; margin: 0; padding: 0; height: 210px; width: 500px; background-color: #F79321; position: relative; }
ul#goods li img { position: absolute; left: 0; top: 0; width: 300px; height: 210px; }
ul#goods li .title { margin-left: 300px; padding: 10px; width: 180px; font-weight: bold; font-size: 1.2em; background-color: #000; color: #fff; overflow: hidden; }
ul#goods li .author { margin-left: 300px; padding: 10px 10px 0 10px; width: 180px; font-weight: bold; background-color: #F79321; color: #fff; }
第四步:一行啟用
. 代碼如下:
$(document).ready(function() {
$('#goods').cycle();
});
就這樣。不給任何參數時,Cycle 會自動把樣式改成一次只顯示一項,並每 4 秒以淡入淡出切換到下一張。
自訂參數
. 代碼如下:
$(document).ready(function() {
$('#goods').cycle({
timeout: 2000, // 每張停留 2000ms
speed: 200, // 切換動畫耗時 200ms
pause: true // 滑鼠移入時暫停
});
});
timeout 是「停在這張多久」,speed 是「換圖這個動作花多久」,兩者常被搞混。把 pause 設為 true 在投影片裡有可點擊連結時特別有用,否則使用者還沒點到就換台了。
特效:fx 參數
. 代碼如下:
$('#goods').cycle({
fx: 'fade',
timeout: 2000,
speed: 200,
pause: true
});
可用的特效很多:blindX、blindY、cover、curtainX、curtainY、fade、fadeZoom、growX、growY、none、scrollUp、scrollDown、scrollLeft、scrollRight、shuffle、slideX、slideY、toss、uncover、wipe、zoom 等等。想要多特效隨機切換,可以傳陣列:fx: ['fade', 'scrollUp', 'shuffle']。
另外幾個實務上常用的:next / prev 指定上一張下一張按鈕的選擇器、pager 指定頁碼指示器容器、manualTrump 讓手動操作時重置計時、random 打亂初始順序。
現況提醒
Cycle 早已停止維護,最後版本停留在 2013 年左右。它依賴 $.browser 這類在 jQuery 1.9 已被移除的 API,若要跑在新版 jQuery 上必須額外載入 jQuery Migrate。新專案請直接改用 Slick、Swiper 或 Embla Carousel,這些仍在維護、支援觸控手勢、也顧及無障礙(例如 aria-live 與鍵盤操作)。維護老網站時,則建議先把 jQuery 鎖在 1.x 並保留 Cycle,不要邊升級邊除錯兩件事一起做。