這是第一篇整理,內容偏向「每個專案都會用到」的基礎片段:限制輸入、封裝 DOMContentLoaded、手寫一個迷你 AJAX、跨域 JSONP,以及千分位格式化。
$("input").keyup(function () {
$(this).val($(this).val().replace(/\D|^0/g, '')); // 只留大於 0 的正整數
}).bind("paste", function () { // 貼上時也要過濾
$(this).val($(this).val().replace(/\D|^0/g, ''));
}).css("ime-mode", "disabled"); // 嘗試關閉輸入法
若允許小數:
$("#rnumber").keyup(function () {
$(this).val($(this).val().replace(/[^0-9.]/g, ''));
}).bind("paste", function () {
$(this).val($(this).val().replace(/[^0-9.]/g, ''));
}).css("ime-mode", "disabled");
兩個重點:一是 keyup 之外一定要處理 paste,否則貼上就漏了;二是 ime-mode: disabled 是 IE 專屬屬性,在其他瀏覽器無效,別以為它能擋中文輸入法。另外 bind() 在 jQuery 3 已移除,請改用 on()。這個寫法只擋字元,不擋「1.2.3」這種多點輸入,若要嚴格限制格式,仍需額外驗證。
// 事件佇列與狀態旗標
var eventQueue = [];
var isReady = false;
var isBind = false;
// 註冊:若 DOM 已就緒則立即執行,否則排入佇列
function domReady(fn) {
if (isReady) {
fn.call(window);
} else {
eventQueue.push(fn);
}
bindReady();
}
// 綁定:現代瀏覽器用 DOMContentLoaded,舊 IE 靠 doScroll 探測
function bindReady() {
if (isReady || isBind) return;
isBind = true;
if (window.addEventListener) {
document.addEventListener('DOMContentLoaded', execFn, false);
} else if (window.attachEvent) {
doScroll();
}
}
// 舊 IE:當 body 尚未完成時 doScroll 會丟錯,重試直到成功
function doScroll() {
try {
document.documentElement.doScroll('left');
} catch (error) {
return setTimeout(doScroll, 20);
}
execFn();
}
// 依序執行佇列中的所有回呼,並清空
function execFn() {
if (!isReady) {
isReady = true;
for (var i = 0; i < eventQueue.length; i++) {
eventQueue[i].call(window);
}
eventQueue = [];
}
}
domReady(function () { /* js 檔 1 */ });
domReady(function () { /* js 檔 2 */ });
這份封裝有三個值得學的設計。第一是佇列:把回呼排隊而不是直接綁事件,才能保證執行順序與註冊順序一致。第二是狀態旗標:isReady 讓「DOM 已就緒後才註冊」的情況能立刻執行,isBind 避免重複綁定。第三是doScroll 技巧:舊 IE 沒有 DOMContentLoaded,但在 body 未就緒時呼叫 documentElement.doScroll 會丟例外,因此反覆重試直到成功,就等於「DOM 好了」。
一個重要提醒(原範例也註明了):以 async 動態載入的腳本不要綁 domReady。因為在它下載完成之前,DOMContentLoaded 早已觸發,那時才 addEventListener 已經攔不到事件了。這種情況要養成檢查 document.readyState 的習慣。
先封裝 XHR 物件的建立:
var createAjax = function () {
var xhr = null;
try {
xhr = new ActiveXObject("microsoft.xmlhttp"); // 舊 IE
} catch (e1) {
try {
xhr = new XMLHttpRequest(); // 標準
} catch (e2) {
window.alert("您的瀏覽器不支援 ajax,請更換!");
}
}
return xhr;
};
再寫核心函式,用設定物件傳入參數:
var ajax = function (conf) {
var type = conf.type || "get"; // 預設 get
var url = conf.url; // 必填
var data = conf.data; // post 時使用
var dataType = conf.dataType || "text"; // text / xml / json
var success = conf.success;
var xhr = createAjax();
xhr.open(type, url, true);
if (type == "GET" || type == "get") {
xhr.send(null);
} else if (type == "POST" || type == "post") {
xhr.setRequestHeader("content-type", "application/x-www-form-urlencoded");
xhr.send(data);
}
xhr.onreadystatechange = function () {
if (xhr.readyState == 4 && xhr.status == 200) {
if (dataType == "text" || dataType == "TEXT") {
success && success(xhr.responseText);
} else if (dataType == "xml" || dataType == "XML") {
success && success(xhr.responseXML);
} else if (dataType == "json" || dataType == "JSON") {
success && success(JSON.parse(xhr.responseText)); // 勿用 eval
}
}
};
};
用法:
ajax({
type: "post",
url: "test.jsp",
data: "name=dipoo&info=good",
dataType: "json",
success: function (data) { alert(data.name); }
});
這份實作有兩處我做了修正。一是 JSON 解析改用 JSON.parse 而非 eval("(" + text + ")")——eval 會執行任何程式碼,若回應被注入惡意腳本就等於在頁面開了後門,JSON.parse 只解析資料,安全且更快。二是補上 xhr.status == 200 的檢查,並建議加上 onerror 與逾時處理,否則請求失敗時會靜默無聲。
同源政策下 XHR 無法跨域取資料,早期最通用的解法是 JSONP:動態插入一個 script 標籤,讓後端回傳一段「呼叫你指定函式」的 JavaScript。
這份 Sjax 的實作把各家瀏覽器對 script 元素的事件差異處理得很細,註解裡甚至記錄了實測結果:IE6/7/8 支援 onreadystatechange,IE9/10 同時支援 onload 與 onreadystatechange,Firefox/Safari/Chrome/Opera 支援 onload,而 onerror 在舊 IE 與 Opera 上不可用。因此它對 Opera 用「延遲若干秒後檢查 done 旗標」的方式模擬錯誤回呼:
Sjax = (function (win) {
var ie678 = !-[1,],
opera = win.opera,
doc = win.document,
head = doc.getElementsByTagName('head')[0],
timeout = 3000,
done = false;
function _serialize(obj) { // 把物件序列化成 a=1&b=2
var a = [], key, val;
for (key in obj) {
val = obj[key];
if (val.constructor == Array) {
for (var i = 0; i < val.length; i++) {
a.push(key + '=' + encodeURIComponent(val[i]));
}
} else {
a.push(key + '=' + encodeURIComponent(val));
}
}
return a.join('&');
}
function request(url, opt) {
function fn() {}
var opt = opt || {},
data = opt.data,
success = opt.success || fn,
failure = opt.failure || fn,
scope = opt.scope || win,
timestamp = opt.timestamp;
if (data && typeof data == 'object') { data = _serialize(data); }
var script = doc.createElement('script');
function callback(isSucc) {
if (isSucc) {
if (typeof jsonp != 'undefined') { // 後端回傳的資料掛在這個全域變數上
done = true;
success.call(scope, jsonp);
} else {
failure.call(scope);
}
} else {
failure.call(scope);
}
// 清理,避免 IE 的記憶體洩漏
script.onload = script.onerror = script.onreadystatechange = null;
jsonp = undefined;
if (head && script.parentNode) { head.removeChild(script); }
}
function fixOnerror() { // 沒有 onerror 的瀏覽器用逾時補救
setTimeout(function () { if (!done) { callback(); } }, timeout);
}
if (ie678) {
script.onreadystatechange = function () {
var rs = this.readyState;
if (!done && (rs == 'loaded' || rs == 'complete')) { callback(true); }
};
} else {
script.onload = function () { callback(true); };
script.onerror = function () { callback(); };
if (opera) { fixOnerror(); }
}
if (data) { url += (url.indexOf('?') > -1 ? '&' : '?') + data; }
if (timestamp) {
url += (data ? '&ts=' : '?ts=') + (new Date).getTime();
}
script.src = url;
head.insertBefore(script, head.firstChild);
}
return { load: request };
})(this);
呼叫方式:
Sjax.load('jsonp66.js', {
success: function () { alert(jsonp.name); },
failure: function () { alert('error'); }
});
註解裡提到的 timeout 取值很有故事:原本設 2 秒在辦公室網路測試沒問題,但換成 3G 之後,即使檔案存在也會因網速太慢而讓 failure 搶先執行,因此調成 5 秒才合理。這是很好的提醒——逾時值必須對最差的網路情境寬容。
不過要清楚 JSONP 的本質與代價:它讓目標網域能在你的頁面執行任意 JavaScript,因此只能載入你完全信任的來源。若對方被入侵或回傳被攔改,你的頁面就等同被控制。此外它只支援 GET,無法帶自訂標頭,錯誤處理也天生脆弱。今天若要在伺服器之間跨域取資料,正確作法是 CORS(伺服器端設定 Access-Control-Allow-Origin);若只是要抓第三方公開資料而無法控制對方標頭,才退回 JSONP 並慎選來源。
function toThousands(num) {
var num = (num || 0).toString(), result = '';
while (num.length > 3) {
result = ',' + num.slice(-3) + result; // 從尾端每次切三位
num = num.slice(0, num.length - 3);
}
if (num) { result = num + result; }
return result;
}
它從尾端每次取三位補上逗號,直到剩下不足三位為止。這個版本直覺好懂,但不處理小數與負號——若輸入是 "-1234.56",結果會是 "-1,234.56" 剛好正確,但 "1234.5678" 會變成 "1,234.5678" 中的小數部分也被切分。要處理小數,可先以 . 切開整數與小數部分,只格式化整數,最後再拼回去;或直接改用 Number.prototype.toLocaleString() 與 Intl.NumberFormat,一行就能完成且支援幣別、百分比與各地區的分隔符號習慣。