DIV CSS 佈局教程網

JavaScript 實用小工具收藏(一):輸入限制、DOM Ready、AJAX 與 JSONP
編輯:關於JavaScript     

這是第一篇整理,內容偏向「每個專案都會用到」的基礎片段:限制輸入、封裝 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」這種多點輸入,若要嚴格限制格式,仍需額外驗證。

二、封裝 DOMContentLoaded

// 事件佇列與狀態旗標
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 的習慣。

三、手寫一個迷你 AJAX

先封裝 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 與逾時處理,否則請求失敗時會靜默無聲。

四、跨域請求:JSONP

同源政策下 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,一行就能完成且支援幣別、百分比與各地區的分隔符號習慣。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved