很多時候,我們對 jQuery 的認識停留在選擇器與基礎 DOM 操作上,但真正讓開發效率倍增的,往往是那些不常被提及的進階方法。本文整理了幾個實用價值極高的 API,透過具體範例帶你理解它們的行為與適用情境。
addBack() 會將上一鏈式操作的選擇結果重新加入當前的集合中,可以把它想成是 end() 的「反向操作」。以下範例選取 third-item 之後的所有相鄰節點,並把 third-item 本身也一併納入:
$( "li.third-item" ).nextAll().addBack(). .css( "background-color", "red" );
對比 end() 更能看出差異:end() 會退回上一個集合,而 addBack() 則是合併兩個集合。
$( "div.after-addback").find("p").addBack().addClass("background"); $( "div.after-addback").find("p").end().addClass("background");
透過 fire() 可以帶入參數逐一呼叫已註冊的函式:
var foo = function(value){ console.log( "foo:" + value ); } var callbacks = $.Callbacks(); callbacks.add(foo); callbacks.fire("hello"); callbacks.fire("world");
lock() 用於鎖住整個 callback 列表,且不接受任何參數。鎖定後便無法再觸發既有的函式,除非改用 memory 標識建立新的 callback 物件:
var foo = function( value ) { console.log( "foo:" + value ); }; var bar = function( value ){ console.log( "bar:" + value ); } var callbacks = $.Callbacks(); callbacks.add( foo ); callbacks.fire( "hello" ); // 輸出 "foo: hello" callbacks.lock(); // 此後不能再調用foo方法,除非$.Callbacks("memory") ,可以add一個函數 callbacks.fire( "world" ); // 沒有調用foo方法 callbacks.add( bar ); // 當callbacks 賦值為 $.Callbacks("memory") ,創建一個callback對象,使用memory標識,可以再add一個函數 callbacks.fire( "world" ); // 輸出 "bar: hello"
promise() 會在既有的 Deferred 物件基礎上,另外回傳一個關聯的 Deferred 物件,常用於延遲執行與非同步流程控制:
$(function(){ $("input[type=button]").click(function(){ $.ajax({ url : "validate.html", type : "POST", dataType : "json" }).done(function(data){ alert(data.a); }).fail(function(){ alert("error"); }) }); var dtd = $.Deferred(); var wait = function(dtd){ var tasks = function(){ alert("執行完畢!"); dtd.resolve(); // 改變Deferred對象的執行狀態 }; setTimeout(tasks,5000); }; dtd.promise(wait); wait.done(function(){ alert("哈哈,成功了!"); }).fail(function(){ alert("出錯啦!"); });
透過 animate 的 step 選項,可以在一個元素動畫的過程中同步驅動其他元素:
$( "#go" ).click(function() { $( ".block:first" ).animate({ left: 100 }, { duration: 1000, step: function( now, fx ){ $( ".block:gt(0)" ).css( "left", now ); } }); });
clone() 常與 appendTo 搭配使用。先看直接搬移元素的情況,原始結構如下:
<div class="container"> <div class="hello">Hello</div> <div class="goodbye">Goodbye</div> </div>
使用 appendTo 會把 hello 直接搬進 goodbye 內部:
$( ".hello" ).appendTo( ".goodbye" );
結果是:
<div class="container"> <div class="goodbye"> Goodbye <div class="hello">Hello</div> </div> </div>
若改用 clone(),則會保留原本元素,另外複製一份放進 goodbye:
$( ".hello" ).clone().appendTo( ".goodbye" );
結果是:
<div class="container"> <div class="hello">Hello</div> <div class="goodbye"> Goodbye <div class="hello">Hello</div> </div> </div>
掌握這些進階方法,能讓你在處理鏈式操作、非同步流程與 DOM 複製時更加游刃有餘。