首頁想隨機展示幾張圖片,每次重新整理都換一批——這類「隨機抽 n 項顯示」的需求,可以封裝成一個可重複使用的 jQuery 外掛。
$(function ($) {
$.fn.changeList = function (options) {
var defaults = {
tag: 'li', // 觸發元素
subName: '.utilTabSub', // 子項目的選擇器
eventType: 'click', // 觸發事件
num: 4, // 顯示幾項
showType: 'show' // 顯示效果
},
opts = $.extend({}, defaults, options),
that = $(this),
subUl = that.find(opts.subName),
subItems = subUl.find('li'),
size = subItems.length,
liW = subItems.outerWidth(true),
ulW = liW * size,
page = size + 1,
n = opts.num,
randNum = 0,
m = 0;
if (size > n) {
that.find(opts.tag)[opts.eventType](function () {
randNum = mathRand(n, size);
subItems.hide();
$.each(randNum, function (i, el) {
subItems.eq(el).fadeIn(800);
});
});
}
};
}(jQuery));
用 $.extend 合併預設值與傳入選項,是 jQuery 外掛的標準寫法,讓呼叫端只需指定要改的項目。
把可變參數全部抽成設定——標籤名、子項目選擇器、事件類型、顯示數量都在 defaults 中,換個頁面套用時不必改程式碼,只需傳入不同的 options。
把變數宣告集中在 var 敘述中一次完成,是較易讀的風格,也避免 hoisting 造成的混淆。
size > n 的守衛判斷很重要:若項目數少於要顯示的數量,隨機抽樣會邏輯異常,直接跳過才是對的。
function mathRand(bit, max) {
var num = 0, arr = [], ret = [];
for (var i = 0; i < bit; i++) {
num = Math.floor(Math.random() * max);
if ($.inArray(num, ret) == -1) {
ret.push(num);
} else {
i--; // 抽到重複,退回重抽
continue;
}
}
return ret;
}
用 $.inArray 檢查是否已抽過,重複就 i-- 讓迴圈多跑一次。這個寫法在 bit 接近 max 時會有效能問題(碰撞機率急升),前面提過的 Fisher-Yates 洗牌是更穩定的替代。
程式中有幾個宣告後未使用的變數(liW、ulW、page、m、opts.showType),顯示這份程式碼經過多次修改。實務上建議定期清掉無用變數,否則讀者會花時間推敲「這個是不是哪裡用到了」。
另外 subItems.hide() 後逐一 fadeIn 的做法,若項目很多會產生大量排隊動畫。改用 CSS transition 搭配 stagger delay,或一次 fade in 整個容器,視覺效果更流暢也更好維護。