DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
jQuery 1.4 官方文件詳解:各模組的完整變更清單
編輯:AJAX詳解     

為慶祝 jQuery 四歲生日,團隊發布了這個主要版本。其中包含大量程式撰寫、測試與文件工作。要特別感謝 Brandon Aaron、Ben Alman、Louis-Rémi Babé、 Ariel Flesler、Paul Irish、Robert Katić、Yehuda Katz、Dave Methvin、Justin Meyer、Karl Swedberg 與 Aaron Quint 在修復問題與完成發布上的付出。

下載

依慣例提供兩個版本,壓縮工具已改用 Google Closure:

  • jQuery 壓縮版(23 KB,Gzip 後)
  • jQuery 未壓縮版(154 KB)

Google 也在其 CDN 上放了一份,會自動最小化並壓縮,且託管在快速的快取伺服器上:

https://ajax.googleapis.com/ajax/libs/jquery/1.4/jquery.min.js

直接在您的網站引用這個 URL,就能享受快速載入的優勢。團隊也致力降低大規模升級的痛楚——所有公開函式的簽名都維持不變,但仍建議通讀「可能造成問題的變更清單」。

效能:熱門方法全面重寫

許多常用方法在 1.4 中被重寫了內部實作(外部呼叫方式不變)。分析源碼時發現,透過降低演算法複雜度,可以獲得大幅的效能提升。

更易用的設定函式

以往只有 .attr() 能傳入函式,1.4 把這個能力移植到所有設定型方法:css()、attr()、val()、html()、text()、append()、prepend()、before()、after()、replaceWith()、wrap()、wrapInner()、offset()、addClass()、removeClass()、toggleClass()。

其中幾個方法還會把目前值作為第二個參數傳入:

// 找出所有 A 標籤裡的 "&",用 span 包起來
$("a").html(function (i, html) {
    return html.replace(/&/gi, "<span>&</span>");
});

// 為部分連結的 title 加上補充資訊
$("a[target]").attr("title", function (i, title) {
    return title + " ( opens in new window )";
});

AJAX

嵌套參數序列化。 1.4 借用了 PHP 興起、後由 Ruby on Rails 推廣的格式,{foo: ["bar", "baz"]} 會序列化為 foo[]=bar&foo[]=baz。1.3 時代則是 foo=bar&foo=baz,這種寫法無法編碼只有單一元素的陣列。需要舊行為時可用三種方式切換:

// 全域切換
jQuery.ajaxSettings.traditional = true;
// 單次呼叫切換
jQuery.param(stuff, true);
// 單一請求切換
$.ajax({ data: stuff, traditional: true });

依 content-type 自動判斷。 若回應的媒體類型是 application/json,dataType 預設為 "json";若是 application/javascript,則預設為 "script" 並自動執行。

支援 ETag。 設定 ifModified: true 後,jQuery 會使用可用的快取,並送出 If-None-Match 標頭。

嚴格 JSON 模式。 1.3 及更早版本用 eval 解析 JSON;1.4 在有原生解析器時改用原生方法,並會驗證格式,因此不合法的 JSON(如 {foo: "bar"})會被拒絕。

序列化 HTML5 元素。 .serialize() 現在會包含 datetime、range 等新輸入型別。

AJAX 請求的 context。 所有回調函式中的 this 都會指向指定物件,可以少寫很多閉包:

jQuery.ajax({
    url: "test.html",
    context: document.body,
    success: function () { jQuery(this).addClass("done"); }
});

此外還包括:成功回調的第三個參數改為原始 XHR 物件、即使沒有資料送出也會帶上 Content-Type、可用 jsonpCallback 指定 JSONP 回呼名稱、以及改用 onreadystatechange 取代輪詢以降低資源消耗。

屬性

.css() 與 .attr() 都做了效能優化,且 .attr() 的函式參數能取得目前屬性值:

jQuery('<img alt="enter your name" />')
    .attr("alt", function (index, value) {
        return "Please, " + value;
    });

.val() 同樣支援函式,.text() 則開始支援 text 與 CDATA 節點。

核心

快捷建立元素。 屬性值與事件都能在建立時一併指定,鍵名對應相關的 jQuery 方法名:

jQuery("<div>", {
    id: "foo",
    css: { height: "50px", width: "50px", color: "blue", backgroundColor: "#ccc" },
    click: function () { $(this).css("backgroundColor", "red"); }
}).appendTo("body");

負索引。 .eq(-2)、.get(-2) 現在可用,代表倒數第二個。

新增 .first() 與 .last(),等同 .eq(0) 與 .eq(-1)。

新增 .toArray(),語意上比 .get() 更明確,但不接受參數。

jQuery() 回傳空集合。 1.3 中它會回傳只含 document 的集合;現在回傳空集合,可先建立再動態加入元素。注意 jQuery().ready() 雖仍可用但已標記為陳舊,請改用 jQuery(document).ready() 或 jQuery(function(){})。

單標籤與元素建立路徑統一。 只給標籤名稱時走快速路徑;jQuery("<div>")、jQuery("<div/>")、jQuery("<div></div>") 三種寫法現在共用同一段程式碼。若指定了屬性,則仍透過 innerHTML 交由瀏覽器解析。

CSS

.css() 效能約為過去的兩倍;.addClass()、.removeClass()、.hasClass() 約為三倍。.toggleClass() 現在能一次切換多個 class:

$("div").toggleClass("current active");

資料

.data() 不帶參數時回傳該元素上的完整資料物件,.data(object) 則可一次設定多筆。注意這個物件也包含元素上綁定的事件,操作時要小心。

另一項改進是:查詢資料時若發現沒有新增過任何資料,jQuery 會盡量不去建立那個內部屬性,既提升效能也避免污染 DOM。

效果

除了整段動畫的 easing,現在也能為單一屬性指定:

$("#clickme").click(function () {
    $("div").animate({
        width:  ["+=200px", "swing"],
        height: ["+=50px", "linear"]
    }, 2000, function () {
        $(this).after("<div>Animation complete.</div>");
    });
});

事件

jQuery.proxy() 鎖定函式內的 this:

var obj = {
    name: "John",
    test: function () {
        alert(this.name);
        $("#test").unbind("click", obj.test);
    }
};
$("#test").click(jQuery.proxy(obj, "test"));

多事件綁定:傳入物件即可一次掛上多個事件。

change 與 submit 正常化:包括即時(live)版本,在 IE 上替換為與其他瀏覽器一致的事件實作。

新事件 focusin / focusout:與 focus/blur 類似,但會向上傳遞,適合自己實作事件代理:

$("form").focusout(function (event) {
    var tgt = event.target;
    if (tgt.nodeName == "INPUT" && !tgt.value) {
        $(tgt).after("nothing here");
    }
});

所有事件都能即時化。 除了 ready、focus(用 focusin)、blur(用 focusout),凡能用 .bind() 綁定的都能用 .live()。1.4 特別補上了 change、submit、focusin、focusout、mouseenter、mouseleave 的跨瀏覽器支援。live() 也開始接受資料物件與 context 參數。

ready 事件確保 body 存在,若不存在會輪詢等待。非 IE 瀏覽器的卸載速度也有改善。

DOM 操作

這一塊的效能提升最為明顯:append()、prepend()、before()、after() 均有改善;html() 約為三倍;remove() 與 empty() 達到四倍。

新方法 .detach():把元素從 DOM 移除但保留事件與資料,可暫時移出、處理後再放回。

var foo = $("#foo").click(function () { /* ... */ });
foo.detach();      // 保留處理器
foo.appendTo("body");

新方法 .unwrap():移除父元素,讓子元素取而代之。

<body><div><p>annie</p><p>davey</p></div></body>
$("div").unwrap();
<body><p>annie</p><p>davey</p></body>

節點快取。 jQuery("<div>")、.after("<div>") 這類以字串建立節點的操作會被快取,對大量字串式 DOM 操作的頁面效能提升顯著。

未掛載節點也能操作。 現在可對尚未插入 DOM 的節點執行 before、after、replaceWith,先在游離狀態完成複雜組裝再掛上頁面,能避免過程中的重排。

.clone(true) 也複製資料。 1.3 只複製事件,1.4 連資料一起複製。語意與 jQuery.extend 一致:普通物件與陣列會被複製,自訂物件則不會。

位移與佇列

.offset(coords) 現在可以設定了,並且同樣接受函式參數。

佇列體系經歷了一次大修。.delay() 可依參數讓佇列停滯若干毫秒(預設使用 fx 佇列,可指定其他名稱):

$("div").fadeIn().delay(4000).fadeOut();

佇列中的函式被呼叫時,第一個參數會是一個函式;呼叫它就會自動推進到下一個項目:

jQuery("div").queue("ajax", function (next) {
    var self = this;
    jQuery.getJSON("/update", function (json) {
        $(self).html(json.text);
        next();
    });
}).queue("ajax", function () {
    $(this).fadeIn();
});

.clearQueue() 可清空佇列(預設為 fx),會移除尚未執行的函式但不影響正在執行者。

選擇器與遍歷

以 ID 開頭的選擇器全部獲得優化,速度最快。.index() 重寫後更直觀:

// 第一個 li.current 在所有同輩中的索引
$("li.current").index()

// #more-info 在頁面上所有 h3 中的索引
$("#more-info").index("h3")

新增 .has()(等同選擇器 :has())、.nextUntil()、.prevUntil()、.parentsUntil()。.add() 可指定 context;.closest() 也能指定 DOM 環境以加速(live() 因此同步受益)。

工具函式

jQuery.isEmptyObject() 判斷物件是否無任何屬性(不會檢查參數型別,請自行確保傳入物件);jQuery.isPlainObject() 判斷是否為 {} 建立的單純物件;jQuery.contains() 判斷第二個節點是否嵌在第一個之中;jQuery.noop 是一個空函式,供必須傳函式的場合使用;jQuery.unique() 現在會依文件中的順序排序結果,因此 jQuery 方法回傳的集合也依文件順序排列。

其他

jQuery.browser 改以瀏覽器引擎為中心,例如可用 jQuery.browser.webkit 判斷;不再嘗試在 Java applet 上綁定事件或資料;為配合 Caja 與即將到來的 ECMAScript 5,核心移除了所有 arguments.callee;壓縮工具由 YUI Min 換成 Closure Compiler。

內部重組與測試

1.4 開發的重點之一是建立更易讀易懂的程式碼庫。舊的 core.js 被拆成 attribute.js、css.js、data.js、manipulation.js、traversing.js、queue.js;ready 事件移入 core.js;CSS 與屬性的邏輯不再糾纏在一起。

測試方面,1.4 共修復了 207 個問題(1.3 為 97 個),測試案例從 1.3.2 的 1504 例增至 3060 例,並在 Safari 3.2/4、Firefox 2/3/3.5、IE 6/7/8、Opera 10.10 與 Chrome 上全數通過。

可能造成問題的變更

所有公開函式的簽名都維持不變,但仍請留意以下幾點:

  • .add() 不再單純串接結果,而會混合後依文件順序排列。
  • .clone(true) 會複製事件與資料。
  • jQuery.data(elem) 不再回傳 id,而是該元素的資料快取物件。
  • jQuery() 無參數時不再自動轉為 jQuery(document)。
  • .val("...") 取得 option 或 checkbox 的值不再有歧義,一律依 value 屬性而非文字內容。
  • jQuery.browser.version 現在回傳引擎版本。
  • JSON 校驗更嚴格,格式不符會報錯。若需要評估不嚴格格式的內容,請指定 dataType 為純文字後自行用 eval()。
  • 參數序列化預設改為 PHP/Rails 風格,可用 jQuery.ajaxSettings.traditional = true 切換,或個別請求時傳入 {traditional: true}。
  • 內部的 jQuery.className 已移除。
  • jQuery.extend(true, ...) 不再擴展複雜物件或陣列。
  • AJAX 請求若未指定 dataType 而回應為 text/javascript,將會被執行。
  • 設定 ifModified 會將 ETag 納入考量。

團隊另外準備了一個向後相容插件。若升級後遇到問題,可在 jQuery 之後引入:

<script src="https://code.jquery.com/jquery.js"></script>
<script src="https://code.jquery.com/jquery.compat-1.3.js"></script>

效能測試使用了 Attributes、Class、DOM Manipulation、Empty/Remove 等測試套件,以及 Function Call Profiling 對比 1.3.2 與 1.4。原文附有完整的原始數據表,這裡不另行轉錄。

中文譯文原始署名:coolnalu

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