為慶祝 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:
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 )";
});
嵌套參數序列化。 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() 效能約為過去的兩倍;.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 瀏覽器的卸載速度也有改善。
這一塊的效能提升最為明顯: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 現在回傳引擎版本。eval()。jQuery.ajaxSettings.traditional = true 切換,或個別請求時傳入 {traditional: true}。jQuery.className 已移除。jQuery.extend(true, ...) 不再擴展複雜物件或陣列。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