DIV CSS 佈局教程網

從零開始學jQuery(九):全面解析jQuery工具函數
編輯:JQuery特效代碼     

一、本文概要

這個系列會帶你走進jQuery的世界,裡頭有不少作者的實戰心得與疑難排解方案,就算你早已上手jQuery,讀起來也往往能挖到幾個實用的小技巧。

我們常要用腳本處理各種業務邏輯,其中最常見的就是對陣列與物件的操作。jQuery的工具函數正好為這類操作提供了便利。

二、前言

大部分人用jQuery,僅止於選擇器選物件或做頁面動畫,一旦要處理業務邏輯,往往又自己動手寫一堆算法。本文想提醒你:jQuery在操作物件與陣列上同樣能大幅提升效率,而且還能把常用算法擴充進工具函數裡,實現腳本函數的複用。

三、什麼是工具函數

工具函數是指定義在jQuery物件(也就是變數"$")上的函數,這類函數統稱為工具類函數。比如C#裡最常見的trim():

$.trim(" text ");

原生JavaScript並沒有能同時去除前後空格的trim函數,於是這類常用函數被統稱為"Utilities"函數,對應jQuery官方文檔:

https://docs.jquery.com/Utilities

"$"其實是"window"物件的屬性,所以下面幾種寫法完全等價:

$.trim(" text ");
window.$.trim(" text ");
window.jQuery(" text ");
jQuery.trim(" text ");

四、工具函數分類

工具函數主要分為:

  • 瀏覽器及特性檢測
  • 陣列和物件操作
  • 測試操作
  • 字串操作
  • URL操作

與前幾章不同,本文不再逐一列舉函數清單。實際應用時,比如想操作某個字串,你可以先到「API文檔/Utilities/字串操作」裡查查看有沒有現成的工具函數,沒有的話再考慮自己開發。

五、瀏覽器及特性檢測

jQuery的優秀之處在於跨瀏覽器,通常我們不必為不同瀏覽器寫不同代碼。但如果你是jQuery開發者或外掛開發者,就得自行處理瀏覽器差異,才能為使用者提供跨瀏覽器的體驗。

jQuery提供了下列屬性用於獲取瀏覽器特性:

jQuery.support(1.3版本新增)、jQuery.browser(已廢除)、jQuery.browser.version(已廢除)、jQuery.boxModel(已廢除)。

1.3版本已廢除後三個屬性,這裡不再贅述,我們把焦點放在jQuery.support上。

jQuery.support

回傳值:Object 說明:jQuery 1.3新增,是一組用於展示各瀏覽器特性與bug的屬性集合。這些屬性主要供外掛與內核開發者使用,數值都透過特性檢測(而非瀏覽器檢測)得出。它主要包含以下測試:

boxModel:若頁面與瀏覽器以W3C CSS盒模型渲染則為true,IE 6/7的怪癖模式下為false,document就緒前為null。

cssFloat:若能用cssFloat存取CSS的float值則為true,IE目前返回false(它用styleFloat)。

hrefNormalized:若瀏覽器從getAttribute("href")回傳原封不動的結果則為true,IE返回false(它會正規化URL)。

htmlSerialize:若瀏覽器透過innerHTML插入連結元素時會序列化這些連結則為true,IE目前返回false。

leadingWhitespace:若使用innerHTML時瀏覽器會保留前導空白則為true,IE 6-8目前返回false。

noCloneEvent:若克隆元素時不會連事件處理函數一起複製則為true,IE目前返回false。

opacity:若瀏覽器能正確解釋透明度樣式則為true,IE目前返回false(它用alpha濾鏡)。

tbody:若瀏覽器允許table不含tbody則為true,IE目前返回false(它會自動補上tbody)。

講解:上面屬性繁多,本文只挑兩個來講。

1. 盒模型 boxModel

下圖是W3C標準中的盒模型示意:

假設有如下元素:

<style type="text/css">
.boxModel { width:200px; height:50px; padding:10px; border:solid 5px #FF0000; background-color:#acacac; }
</style>
<div id="divBox" class="boxModel">

顯示效果如下:

CSS中把元素寬度設為200px,下面以此為例說明盒模型。

W3C盒模型:

元素的寬高只算盒模型圖中的Content部分,不含padding、border與margin。目前除IE外,所有瀏覽器都僅支援W3C盒模型。在此模型下,示例含紅框在內的內容寬度為200+2×10+2×5=230px,高度為50+2×10+2×5=80px。

IE盒模型:

設定的寬度包含padding與border,實際內容寬度content Width = width − padding − border。IE5.5及更早版本採用此模型;較高的IE若因故跑在怪異模式下也會用它,所以頁面一定要宣告正確的DOCTYPE。

兩種盒模型的對比如下:

我們可以用jQuery.support.boxModel判斷瀏覽器是否使用W3C盒模型,true即代表使用W3C boxModel。

2. 浮動樣式

用JavaScript設置元素的float樣式時,IE與Firefox並不相同:IE用style.styleFloat,Firefox用style.cssFloat:

div.style.styleFloat = "left"; //IE
div.style.cssFloat = "left"; //FF

jQuery.support.cssFloat返回true代表可用cssFloat設置float,IE中返回false。好在用jQuery的CSS()方法設置float時,內部會自動判斷該用styleFloat還是cssFloat:

$("#divResult").css("float","left"); //兼容IE和FF

六、陣列和物件操作

做UI時我們常操作DOM物件或jQuery包裝集,但寫算法、業務邏輯時,操作的往往是陣列與物件。下面講解最常用的相關工具函數。

1. 迭代

jQuery.each(object, callback) 回傳值:Object

通用的遍歷方法,可用於遍歷物件和陣列。不同於遍歷jQuery物件的$().each(),它可用於遍歷任何物件。回調函數有兩個參數:第一個是成員或索引,第二個是對應的值;若需要提前退出,讓回調返回false即可,其他回傳值會被忽略。

對於jQuery包裝集,可用each(callback)遍歷每個元素,callback接受一個表示索引的參數:

$("img").each(function(i){ this.src = "test" + i + ".jpg"; });

對於陣列,可用jQuery.each(object, callback)遍歷,等同於for循環。第一個參數可以是陣列或物件;若是陣列則遍歷每個元素,回調的第一個參數是索引、第二個是值,this代表當前元素,回傳false可提前終止。比如下面遍歷到第二個元素就停止:

$.each(["a", "b", "c"], function(i, n) {
  alert("Item #" + i + ": " + n);
  if (i >= 1) { return false; }
});

若傳入的是物件,則遍歷它的每個屬性,即使回調返回false也會走完全部屬性,第一個參數是屬性key(屬性名稱,object類型),第二個是值,this代表當前屬性值:

$("#iterateObject").click(function(event) {
  $.each({ name: "ziqiu.zhang", sex: "male", status: "single" }, function(i, n) {
    alert("Item #" + i.toString() + ": " + n);
    if (i >= 1) { return false; }
  });
});

each是我們最常打交道的函數,但要特別注意:它雖然遍歷每個元素或屬性,卻不會改變當前元素的值,也就是無法改動遍歷後的物件。若需要改動陣列裡的每個元素並回傳結果,就該改用jQuery.map(array, callback)。

2. 篩選

jQuery.grep(array, callback, [invert]) 回傳值:Array

用過濾函數篩選陣列元素,至少傳入待過濾陣列與過濾函數,過濾函數回傳true保留、false刪除。預設invert為false(回傳true即保留);設為true則相反(回傳true即刪除)。下面示範過濾掉索引中數值不大於0的元素:

$.grep( [0,1,2], function(n,i){ return n > 0; });

結果為[1,2]。

3. 轉換

jQuery.map(array, callback) 回傳值:Array

把一個陣列的元素轉換到另一個陣列。轉換函數會為每個元素調用,可回傳轉換後的值、null(刪除該項)或一個陣列(展開併入原陣列)。在1.3.2版本中,它與each幾乎相同,唯一差別是回調函數能改變當前元素,回傳null則刪除當前元素。例如:

var arr = [ "a", "b", "c", "d", "e" ];
$("div").text(arr.join(", "));
arr = jQuery.map(arr, function(n, i){ return (n.toUpperCase() + i); });
$("p").text(arr.join(", "));
arr = jQuery.map(arr, function (a) { return a + a; });
$("span").text(arr.join(", "));

4. 合併

合併物件是我們常寫的功能,通常得靠笨重的for循環。jQuery為此提供了多個合併函數:

jQuery.extend([deep], target, object1, [objectN]):用一個或多個物件擴展目標物件並回傳被擴展的物件。若不指定target,則對jQuery命名空間本身擴展,這對外掛作者增加新方法很有幫助。若第一個參數為true,則回傳一個深層副本,遞歸複製其中的物件;否則副本會與原物件共享結構。例如合併settings與options:

var settings = { validate: false, limit: 5, name: "foo" };
var options = { validate: true, name: "bar" };
jQuery.extend(settings, options);
// settings == { validate: true, limit: 5, name: "bar" }

jQuery.makeArray(obj):把類陣列物件轉為陣列物件。類陣列物件有length屬性,成員索引為0到length−1,此函數在jQuery內部會自動使用。例如把DOM集合轉陣列:

var arr = jQuery.makeArray(document.getElementsByTagName("div"));

jQuery.inArray(value, array):確定第一個參數在陣列中的位置,從0起算,找不到回傳−1。例如:

var arr = [ 4, "Pete", 8, "John" ];
jQuery.inArray("John", arr); //3
jQuery.inArray(4, arr); //0
jQuery.inArray("David", arr); //-1

jQuery.merge(first, second):合併兩個陣列,結果會修改第一個陣列——把第二個陣列的元素接在它的後面。要去除重複請用$.unique()。例如:

$.merge( [0,1,2], [2,3,4] ); // [0,1,2,2,3,4]

jQuery.unique(array):刪除陣列中重複的元素,但只處理DOM元素陣列,無法處理字串或數字陣列。例如:

$.unique(document.getElementsByTagName("div"));

講解:上面函數看著有點眼花,我們重點看以後常用的。首先是jQuery.merge(first, second),用來合併兩個陣列,示例如下:

<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<title>jQuery Utilities - jQuery.merge</title>
<script src="../scripts/jquery-1.3.2-vsdoc2.js" type="text/javascript"></script>
<script type="text/javascript">
$(function() {
  $("#go").click(function(event) {
    $("#divResult").html("");
    var first = [1, 3, 5];
    $("#divResult").append("<span>first:[" + first.join(",") + "]</span>").append("<br/>");
    var second = [2, 4, 6];
    $("#divResult").append("<span>second:[" + second.join(",") + "]</span>").append("<br/>");
    var result = $.merge(first, second);
    $("#divResult").append("<span>result:[" + result.join(",") + "]</span>").append("<br/>");
    $("#divResult").append("<span>first after merged:[" + first.join(",") + "]</span><br/>");
    $("#divResult").append("<span>second after merged:[" + second.join(",") + "]</span><br/>");
  });
});
</script>
</head>
<body>
  <button id="go">合併陣列</button><br />
  <div id="divResult"></div>
</body>
</html>

結果如下:

另外,別有了jQuery就忘了原生JavaScript,比merge更常用的其實是join和split。merge函數會改動第一個合併的陣列——要是我來設計就不會這麼做,因為回傳值已經是合併後的陣列了,這樣設計反而讓函數產生歧義。清單裡其他函數就不逐一細講,用到再查即可,除了jQuery.extend這個不得不提的函數,下面單開一節說明。

5. jQuery.extend

開發外掛時,最常用它來處理options。下面是fancybox外掛獲取options的代碼:

settings = $.extend({}, $.fn.fancybox.defaults, settings);

這裡target是一個空物件,把預設設置defaults作為第一個物件,把使用者傳入的setting合併上去:setting裡有的屬性以setting為準,沒有的則沿用default的預設值,最後把結果複製給target並回傳。

看個完整示例:

var empty = {};
var defaults = { validate: false, limit: 5, name: "foo" };
var options = { validate: true, name: "bar" };
var settings = jQuery.extend(empty, defaults, options);
// settings == { validate: true, limit: 5, name: "bar" }
// empty == { validate: true, limit: 5, name: "bar" }

之所以要傳一個空物件當target,是因為target的值最後會被改動。比如:

var defaults = { validate: false, limit: 5, name: "foo" };
var options = { validate: true, name: "bar" };
var settings = jQuery.extend(defaults, options);

把defaults當target,雖然settings結果一樣,但defaults的值被改掉了!而外掛裡的預設值應該保持固定!所以使用時務必留意target的用法。

下面是我的完整示例:

<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<title>jQuery Utilities - jQuery.extend</title>
<script src="../scripts/jquery-1.3.2-vsdoc2.js" type="text/javascript"></script>
<script type="text/javascript">
$.toObjectString = function (obj) {
  var result = "{";
  var counter = 0;
  $.each(obj, function(i, n) {
    if (counter > 0) { result += ","; }
    result += i.toString() + ":" + n.toString();
    counter++;
  });
  result += "}";
  return result;
};
$(function() {
  $("#go1").click(function(event) {
    $("#divResult").html("");
    var empty = {};
    var defaults = { validate: false, limit: 5, name: "foo" };
    var options = { validate: true, name: "bar" };
    var settings = jQuery.extend(empty, defaults, options);
    $("#divResult").append("<span>settings after extend:" + $.toObjectString(settings) + "</span>").append("<br/>");
    $("#divResult").append("<span>defaults after extend:" + $.toObjectString(defaults) + "</span>").append("<br/>");
  });
  $("#go2").click(function(event) {
    $("#divResult").html("");
    var defaults = { validate: false, limit: 5, name: "foo" };
    var options = { validate: true, name: "bar" };
    var settings = jQuery.extend(defaults, options);
    $("#divResult").append("<span>settings after extend:" + $.toObjectString(settings) + "</span>").append("<br/>");
    $("#divResult").append("<span>defaults after extend:" + $.toObjectString(defaults) + "</span>").append("<br/>");
  });
});
</script>
</head>
<body>
  <button id="go1" style="height:40px;width:400px;">jQuery.extend(empty, defaults, options)</button>
  <button id="go2" style="height:40px;width:400px;">jQuery.extend(defaults, options)</button><br />
  <div id="divResult"></div>
</body>
</html>

結果如下:

七、測試工具函數

測試工具函數主要用於判斷物件是否屬於某一類型,回傳的都是Boolean值:

jQuery.isArray(obj) jQuery.isFunction(obj)

同時也別忘了JavaScript自帶的isNaN和isFinite:

var test = "123";
alert(isNaN(test));
alert(isFinite(test));

isNaN判斷參數是否為非數字,是數字則回傳false;isFinite檢查參數是否為無窮大,若參數是NaN或正負無窮大則回傳false,否則回傳true。

八、字串操作工具函數

目前核心類庫裡只有一個字串工具函數:

jQuery.trim(str) 回傳值:string 說明:去掉字串起始與結尾的空格。例如:

$.trim(" hello, how are you? "); // "hello, how are you?"

九、URL操作工具函數

jQuery.param(obj) 回傳值:string 說明:將表單元素陣列或物件序列化,是.serialize()的核心方法。陣列或jQuery物件按name/value序列化,普通物件按key/value序列化。例如:

var params = { width:1680, height:1050 };
var str = jQuery.param(params); // width=1680&height=1050
$("#results").text(str);

jQuery把它歸為URLs分類,因為此方法常用於發送GET請求時把物件作為URL參數傳給伺服器。

十、擴展工具函數與jQuery包裝集函數

擴展工具函數只需對jQuery(即"$")擴展即可。由於"$"可能與其他腳本庫衝突,通常我們用下面的語法來開發工具函數:

(function($) {
  $.myExtendMethod = function(o) { alert(0); };
})(jQuery);

這樣在函數體內的"$"就能保證代表jQuery物件。不過這種方式享受不到智能感知,一般我們會把擴展的工具函數與包裝集函數都放到同一個獨立檔案中。下面示例演示如何添加自定義的jQuery工具方法與包裝集方法:

/// <reference path="jquery-1.3.2-vsdoc2.js" />
jQuery.myExtendMethod = function(o) {
  /// <summary>擴展方法註釋.</summary>
  /// <param name="o" type="String">參數提示文字</param>
  /// <returns type="string">返回值提示文字</returns>
  alert(0);
};
jQuery.fn.myExtendMethod = function(o) {
  /// <summary>擴展方法註釋.</summary>
  /// <param name="o" type="String">參數提示文字</param>
  /// <returns type="string">返回值提示文字</returns>
  alert(0);
};

透過第一行的reference,我們就能在這個js檔裡繼續享受jQuery的智能感知。jQuery.myExtendMethod擴展的是工具函數,而jQuery.fn.myExtendMethod擴展的是jQuery包裝集函數,也就是為$()取到的物件加上方法。同理,用XML註釋(如<summary>)還能為自定義方法添加智能提示,腳本中的XML註釋與.NET裡的一樣。

十一、總結

jQuery提供了大量工具函數,一般情況下足以應付所需。但像JSON格式化這類操作,就得靠我們自己擴展;市面上各種擴展組件能大幅提升開發效率,本系列Ajax章節就介紹過一個JSON序列化組件jQuery.json,更多好用的組件還有待你在工作中慢慢發掘。

作者:張子秋 出處:https://www.cnblogs.com/zhangziqiu/

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