以前寫 JavaScript 總是臨時在頁面上丟幾個函式,很少思考封裝與重用。這篇筆記嘗試模仿 jQuery 的 chained API 風格,自己包一個小型類庫,並用它實作「圖片等比縮放 + 預先載入」的效果。
$$.imgResize({...})。(function () {
var yQuery = (function () {
var yQuery = function () {
return yQuery.fn.init();
};
yQuery.fn = yQuery.prototype = {
init: function () {
return this;
},
// 圖片等比縮放與預載入
imgResize: function (e) {
return new imgResizeBox(e);
}
};
// ---- image 圖片處理 ----
var imgResizeBox = function (e) {
var setting = {
imgId: "", // 圖片容器的選擇器,例如 .viewArea img
height: 0,
width: 0,
loading: "images/lightbox-ico-loading.gif" // 載入中的佔位圖
};
$.extend(setting, e, setting); // 參數替換
var images = $(setting.imgId);
$(images).hide();
// 先插入 loading 動圖
var loading = new Image();
loading.className = "loading";
loading.src = setting.loading;
$(images).after(loading);
// 預載入:等圖片真的下載完成才處理
var perLoading = function ($this) {
var img = new Image();
img.src = $this.src;
if (img.complete) { // 已從快取命中
computeImg.call($this);
return;
}
img.onload = function () {
computeImg.call($this);
img.onload = function () {}; // 避免重複觸發
};
};
// 等比縮放並顯示
var computeImg = function () {
var m = this.height - setting.height;
var n = this.width - setting.width;
if (m > n) {
this.height = this.height > setting.height ? setting.height : this.height;
} else {
this.width = this.width > setting.width ? setting.width : this.width;
}
$(this).next(".loading").remove();
$(this).show();
};
return $(images).each(function () {
perLoading(this);
});
};
return yQuery;
})();
window.yQuery = window.$$ = yQuery();
})();
$(document).ready(function () {
$$.imgResize({
imgId: ".viewArea img",
height: 160,
width: 270,
loading: "https://www.jb51.net/images/2012/155618/2012062710243954.gif"
});
});
imgResize 中 return new imgResizeBox(e) 的寫法略顯彆扭。更一致的 chaining 風格應該是回傳 this(或回傳 jQuery 物件),讓呼叫端能串接下去。$.extend(setting, e, setting) 的參數順序有問題:最後一個參數會覆蓋前面所有結果,等於永遠採用預設值。正確寫法應是 $.extend({}, setting, e),既保留預設值又讓外部設定生效,且不汙染原始 setting。after() 插入到每張圖片後方,圖片多時會產生多個 loading;實務上通常一個容器共用一個即可。這次練習最大的收穫不是效果本身,而是重新思考「怎麼把常用邏輯包成可重複調用的介面」。即使不打算自製類庫,養成這種封裝習慣,對後續讀懂 jQuery 外掛原始碼也很有幫助。