首頁幾乎一定要有一組焦點輪播。做專案時在網上找到一個半成品插件,改掉不合用的部分後整理成這份筆記,順便記錄一個 jQuery 插件的標準骨架該長什麼樣子。
js 資料夾下有兩個檔案:jquery.jslide.js 是改寫後的版本,jquery.jslides.js 保留原作者的版本以備對照。

<div class="slide_wrap">
<ul id="slides2" class="slide">
<li style="background:url('images/01.jpg') no-repeat center top">
<a href="https://www.cnblogs.com/" target="_blank">pwstrick1</a></li>
<li style="background:url('images/02.jpg') no-repeat center top">
<a href="https://www.cnblogs.com/" target="_blank">pwstrick2</a></li>
<li style="background:url('images/03.jpg') no-repeat center top">
<a href="https://www.cnblogs.com/" target="_blank">pwstrick3</a></li>
<li style="background:url('images/04.jpg') no-repeat center top">
<a href="https://www.cnblogs.com/" target="_blank">pwstrick4</a></li>
</ul>
</div>
幾個設計決定值得說明:
1. 用 background 而非 img 呈現圖片。現在流行寬幅焦點圖,用背景圖就不會因為圖片寬度超出視窗而產生橫向捲軸。
2. 外層 slide_wrap 作為定位錨點。裡面的 li 全都是絕對定位疊在一起,需要一個 relative 的父層來對齊。
3. class 預先寫在 HTML 裡。原本是在插件初始化時才加上去,改成先寫好,顯示效果比較穩定——因為少了「先以無樣式狀態渲染、再套上樣式」的閃爍。
.slide_wrap { width: 100%; height: 400px; position: relative; }
.slide_wrap .slide {
display: block; width: 100%; height: 400px;
list-style: none; padding: 0; margin: 0; position: relative;
}
.slide_wrap .slide li {
display: block; width: 100%; height: 100%;
list-style: none; padding: 0; margin: 0; position: absolute;
}
.slide_wrap .slide li a {
display: block; width: 100%; height: 100%; text-indent: -9999px;
}
.slide_wrap .pagination {
display: block; list-style: none;
position: absolute; left: 50%; top: 340px;
z-index: 9900; padding: 5px 15px 5px 0; margin: 0;
}
.slide_wrap .pagination li {
display: block; list-style: none;
width: 10px; height: 10px; float: left;
margin-left: 15px; border-radius: 5px; background: #FFF;
}
.slide_wrap .pagination li a {
display: block; width: 100%; height: 100%;
padding: 0; margin: 0; text-indent: -9999px; outline: 0;
}
.slide_wrap .pagination li.current { background: #0092CE; }
slide_wrap 與 slide 的高度可依實際版面調整;pagination 是下方的小圓點,left 與 top 決定它的位置;各項顏色都能依主題替換。
<script type="text/javascript">
$('#slides2').jslide();
</script>
把 ul 交給插件,之後所有操作都圍繞這個 ul 進行。
;(function (factory) {
'use strict';
// 支援 AMD 模組載入器(如 RequireJS)
if (typeof define === 'function' && define.amd) {
define(['jquery'], factory);
} else {
factory(jQuery);
}
}(function ($, undefined) {
'use strict';
$.fn.jslide = function (method) {
return _init.apply(this, arguments);
};
}));
這個骨架裡每個看似奇怪的細節都有理由:
開頭的分號是為了防止插件被壓縮合併成一行時,與前一段程式碼黏在一起造成語法錯誤,例如 var i=0(function(factory){...}(..));。
'use strict' 開啟嚴格模式,讓 JS 引擎以更嚴格的規則解析,能提早發現例如未宣告變數、刪除不可刪除的屬性等問題。
define 那段讓插件相容於 AMD 規範,使用 RequireJS 的專案才能正確載入。
function ($, undefined) 裡的 undefined 參數,是為了避免其他腳本把全域的 undefined 重新賦值,導致插件內部的 undefined 判斷失效。
var defaults = {
speed: 3000,
pageCss: 'pagination',
auto: true // 是否自動切換
};
var nowImage = 0; // 目前顯示第幾張
var pause = false; // 是否暫停
var autoMethod; // 定時器編號
function _init(opts) {
opts = $.extend({}, defaults, opts || {});
var $items = $(this);
for (var i = 0, count = $items.length; i < count; i++) {
_build($items.eq(i), opts);
}
return $items;
}
defaults 是對外開放的三個參數;三個全域變數分別記錄目前索引、暫停狀態與定時器編號;_init 合併自訂參數後逐個建置。
function _getSlides($node) {
return $node.children('li');
}
function _build($node, opts) {
var $slides = _getSlides($node);
$slides.eq(0).siblings('li').css({ 'display': 'none' });
var numpic = $slides.size() - 1;
$node.delegate('li', 'mouseenter', function () {
pause = true;
clearInterval(autoMethod);
}).delegate('li', 'mouseleave', function () {
pause = false;
autoMethod = setInterval(function () { _auto($slides, $pages, opts); }, opts.speed);
});
var $pages = _pagination($node, opts, numpic);
if (opts.auto) {
autoMethod = setInterval(function () { _auto($slides, $pages, opts); }, opts.speed);
}
}
先隱藏除第一張以外的所有 li;把滑鼠移入與移出綁成暫停與恢復輪播;初始化分頁按鈕;最後依 auto 參數決定要不要啟動自動播放。
function _pagination($node, opts, size) {
var $ul = $('<ul>', { 'class': opts.pageCss });
for (var i = 0; i <= size; i++) {
$ul.append('<li><a href="javascript:void(0)">' + (i + 1) + '</a></li>');
}
$ul.children(':first').addClass('current');
var $pages = $ul.children('li');
$ul.delegate('li', 'click', function () {
_changePage($pages, $node, $(this).index());
}).delegate('li', 'mouseenter', function () {
pause = true;
}).delegate('li', 'mouseleave', function () {
pause = false;
});
$node.after($ul);
return $pages;
}
function _fadeinout($slides, $pages, next) {
$slides.eq(nowImage).css('z-index', '2');
$slides.eq(next).css({ 'z-index': '1' }).show();
$pages.eq(next).addClass('current').siblings().removeClass('current');
$slides.eq(nowImage).fadeOut(400, function () {
$slides.eq(next).fadeIn(500);
});
}
同時拉高兩張圖的 z-index,先讓下一張顯示出來,再讓舊圖淡出——這樣做出的是柔和的交疊漸變;若不處理層級,切換會非常生硬。
function _auto($slides, $pages, opts) {
var next = nowImage + 1;
var size = $slides.size() - 1;
if (!pause) {
if (nowImage >= size) { next = 0; }
_fadeinout($slides, $pages, next);
if (nowImage < size) { nowImage += 1; } else { nowImage = 0; }
} else {
clearInterval(autoMethod);
}
}
這個版本仍有明顯限制:同一頁面無法同時初始化兩組不同設定的輪播,因為 nowImage、pause、autoMethod 都是閉包外的全域變數。要修正就得把狀態收進以每個元素為單位的資料物件裡,例如用 $node.data('jslide', {...}) 保存,並把 methods 改成 $.fn.jslide = function(method){...} 的 dispatch 形式。
另外 .size() 已在 jQuery 3 中移除,應改用 .length;.delegate() 也已廢棄,建議改寫成 $node.on('mouseenter', 'li', handler)。
整體走過一遍之後,最大的收穫是擁有了自己的輪播插件——雖然不完美,但知道每一行在做什麼,之後要加自動播放的進度條、手勢滑動、無限循環,都改得動。
Demo:https://demo.cnblogs.com/js/2014/jsilde/