jQuery 1.4 發布了,而且超乎眾人預期——這不是一次小修小補,而是包含大量新特性、功能增強與效能提升的大版本。以下整理十五項最實用的改動。
想立刻試用:
https://code.jquery.com/jquery-1.4.js
以往要設定元素屬性得用 attr()。1.4 起,你可以直接把一個物件作為第二個參數傳給 jQuery 函式,同時建立元素:
jQuery('<a/>', {
id: 'foo',
href: 'https://google.com',
title: 'Become a Googler',
rel: 'external',
text: 'Go to Google!'
});
其中 text 並非真正的屬性,它會呼叫 jQuery 內部的 .text() 方法,把文字設為「Go to Google!」。更有用的例子:
jQuery('<div/>', {
id: 'foo',
css: { fontWeight: 700, color: 'green' },
click: function () { alert('Foo has been clicked!'); }
});
id 當一般屬性直接掛上,css 與 click 則觸發對應的 jQuery 方法。1.4 以前同樣的事得這樣寫:
jQuery('<div/>')
.attr('id', 'foo')
.css({ fontWeight: 700, color: 'green' })
.click(function () { alert('Foo has been clicked!'); });
DOM 遍歷工具新增三個方法,會朝指定方向走訪,直到遇上符合選擇器的元素為止。以下有一張水果清單:
<ul> <li>Apple</li> <li>Banana</li> <li>Grape</li> <li>Strawberry</li> <li>Pear</li> <li>Peach</li> </ul>
要挑出 Apple 之後、Pear 之前的所有項目:
jQuery('ul li:contains(Apple)').nextUntil(':contains(Pear)');
// 得到 Banana、Grape、Strawberry
不必再把各個事件串成一條鏈,現在可以一次打包:
jQuery('#foo').bind({
click: function () { /* ... */ },
mouseover: function () { /* ... */ },
mouseout: function () { /* ... */ }
});
.one() 也支援同樣的寫法。
以前一個動畫只能套用一種緩動函式(jQuery 原生支援 swing 與 linear,其他需另行下載)。現在可以為每個屬性分別指定:
jQuery('#foo').animate({
left: 500,
top: [500, 'easeOutBounce']
}, 2000);
也可以在選項物件中用 specialEasing 達成同樣效果:
jQuery('#foo').animate({
left: 500,
top: 500
}, {
duration: 2000,
specialEasing: { top: 'easeOutBounce' }
});
值得一提的是,這個功能是作者 James Padolsey 自己想出來的。
1.4 為 .live() 增加了 submit、change、focus、blur 的支援。當你要為大量元素註冊事件,甚至希望未來才出現的元素也一併生效時,這非常省事。
不過要注意:註冊 focus 與 blur 時,事件名必須寫成 focusin 與 focusout。
jQuery('input').live('focusin', function () {
// 在這裡處理 this
});
JavaScript 的 this 一向難纏。1.4 新增的 proxy 函式接受作用域與函式(或方法名)兩個參數,回傳一個 this 被鎖定的函式。
var app = {
config: { clickMessage: 'Hi!' },
clickHandler: function () {
alert(this.config.clickMessage);
}
};
app.clickHandler(); // 正常,彈出 "Hi!"
但若把它當事件處理器:
jQuery('a').bind('click', app.clickHandler);
點下去什麼也不會發生。因為 jQuery 預設把處理器的 this 指向被點擊的元素,此時 this 是那個錨點,而我們要的是 app。解法:
jQuery('a').bind('click', jQuery.proxy(app, 'clickHandler'));
現在點任何錨點都會彈出「Hi!」。這個函式在把回調傳給其他 jQuery 方法或插件時同樣好用。
.delay() 讓你在兩個動畫之間停一拍,不必再搬出 setTimeout 或回調:
jQuery('#foo')
.slideDown()
.delay(200)
.fadeIn();
若要操作 fx 以外的佇列,把佇列名稱作為第二個參數傳入即可。
jQuery('div').has('ul');
這會從所有 div 中挑出包含 ul 的那些。與選擇器 :has() 的邏輯一致,但在需要程式化地逐步縮小集合時更好用。
1.4 同時在 jQuery 命名空間下新增了低層的 contains 函式,接受兩個 DOM 節點,回傳布林值:
jQuery.contains(document.documentElement, document.body); // true —— body 確實在 html 之中
很久以前就有 .wrap() 能替元素裹一層皮,1.4 補上了反向操作:
<div><p>Foo</p></div>
jQuery('p').unwrap();
結果:
<p>Foo</p>
這個方法會移除任意元素的父元素。
原本的 .remove() 會把元素丟掉連帶清掉資料。全新的 .detach() 則把元素從 DOM 剝離、保留一切,之後還能放回:
var foo = jQuery('#foo');
foo.click(function () { alert('Foo!'); });
foo.detach(); // 從 DOM 移除
// ... 做點別的事
foo.appendTo('body'); // 放回
foo.click(); // 仍然彈出 "Foo!"
需要把某塊 UI 暫時收起、之後再原樣放回時,這個方法非常合適。
1.4 為 .index() 加了兩種新用法。不帶參數時,回傳該元素在同輩中的排位:
jQuery('li').click(function () {
alert(jQuery(this).index());
});
也可以傳入選擇器,回傳該元素在符合此選擇器的集合中的索引。找不到時回傳 -1。
大部分 DOM 操作方法現在都能傳入函式,該函式會為集合中每個元素各跑一次,藉此產生「量身訂做」的值。支援的方法包含 after、before、append、prepend、addClass、toggleClass、removeClass、wrap、wrapAll、wrapInner、val、text、replaceWith、css、attr、html。
jQuery('li').html(function (i) {
return 'Index of this list item: ' + i;
});
設定型方法還能拿到目前值作為第二個參數:
jQuery('a').attr('href', function (i, currentHref) {
return currentHref + '?foo=bar';
});
jQuery('li').css('color', function (i, currentColor) {
return i % 2 ? 'red' : 'blue';
});
css() 與 attr() 之所以要把函式放在第二個參數,是因為第一個參數得用來指定要改哪個屬性。
jQuery.isEmptyObject({}); // true
jQuery.isEmptyObject({foo:1}); // false
jQuery.isPlainObject({}); // true
jQuery.isPlainObject(window); // false
jQuery.isPlainObject(jQuery()); // false
isPlainObject 判斷是否為以 {} 或 new Object() 建立的單純物件。
.closest() 現在可接受一組選擇器,一次尋找多種特徵的最近祖先;也能傳入上下文環境作為第二個參數,藉此控制 DOM 遍歷的深度。這兩個新特性平時未必常用,但一旦用上效果驚人。
jQuery('form')
.focusin(function () { jQuery(this).addClass('focused'); })
.focusout(function () { jQuery(this).removeClass('focused'); });
這兩個事件在元素本身或其子元素取得/失去焦點時都會觸發,而且會向上傳遞(捕獲而非冒泡),也就是說外層元素會先被觸發。做表單的焦點提示時特別好用。
以上就是 1.4 中對日常開發影響最大的十五項改動。如果你還不知道,可以去看看「14 days of jQuery」活動——為慶祝 1.4 發布與 jQuery 四歲生日而辦的線上活動,秀出你的作品還有機會贏得 MediaTemple 一年主機使用權。另外也別錯過全新的 API 文件。