寫 jQuery 久了,有些方法總是記不住彼此差別。以下把實務上高頻出現的方法整理成一份對照筆記。
mouseover() 與 mouseout() 會在指標進入或離開元素「及其後代元素」時觸發。由於事件會冒泡,經常在不需要時被誤觸,衍生一些難查的腳本問題。
mouseenter() 與 mouseleave() 則只在指標真正進入被選元素本身時觸發,穿越子元素不會再觸發一次。做懸停效果時,通常這對才是你要的。
focusin() 與 focusout() 同理:焦點落在元素或其任何子元素上時都會觸發,這是它與 focus() 最大的差異。
$("p").focusin(function() {
$(this).find("span").css("display", "inline").fadeOut(1000);
});
.get() 回傳原生 DOM 元素,.eq() 回傳仍是 jQuery 物件。
$("li").get(0).css("color", "red"); // 錯誤,DOM 元素沒有 css()
$("li").eq(0).css("color", "red"); // 正確
若手上是 DOM 元素卻想用 jQuery 方法,用 $() 再包一次即可:
var li = $("li").get(0);
$(li).css("color", "black");
參數可以是選擇器字串,也可以是函數;函數回傳 false 的元素會被剔除。
$("p").filter(".selected, :first") // 保留第一個與帶 selected 類的
$("p").filter(function(index) {
return $("ol", this).length == 0; // 保留不含 ol 的 p
});
.bind() 是最基本的綁定方式,可傳具名函數或匿名函數:
$("#mydiv").bind("click", function(){
alert("Hello World!");
});
.live() 與 bind 唯一的差別,是它也對「未來才出現」的動態元素生效:
$('.box').live('click', function(){
$(this).clone().appendTo('.container');
});
缺點是 live() 不支援鏈式呼叫。delegate() 就是為了解這個問題而生,它把事件委派到父元素上:
$('.container').delegate('.box', 'click', function(){
$(this).clone().appendTo('.container');
});
參數依序為子元素選擇器、事件名稱、處理函數。1.7 之後,delegate() 已被 .on() 取代,新專案請直接用 on()。
每次篩選都會入棧,end() 負責出棧。
$('ul.one').find(".two").css("color","red").find('.three').css("background","blue");
這段程式裡第二次 find() 的起點是「class 為 two 的元素」,所以找不到 .three。加上 end() 後:
$('ul.one').find(".two").css("color","red").end().find('.three').css("background","blue");
鏈條就回到 $('ul.one') 的狀態,背景色也能正確套上。
前者把「所有符合的元素」用結構標記包起來,後者包的是每個元素的內部內容。
$('.inner').wrap(function() {
return '<div class="' + $(this).text() + '" />';
});
結果:
<div class="container"> <div class="Hello"><div class="inner">Hello</div></div> <div class="Goodbye"><div class="inner">Goodbye</div></div> </div>
換成 wrapInner(),新元素會出現在 .inner 內部:
<div class="container"> <div class="inner"><div class="Hello">Hello</div></div> <div class="inner"><div class="Goodbye">Goodbye</div></div> </div>
.detach([selector]):從 DOM 摘除元素,但保留其事件與資料,適合「先移走、之後再放回」。.empty():只清空內容(包含子元素與文字節點),元素本身還在。.remove([selector]):彻底移除元素,連帶清除綁定的事件與 jQuery 資料。$(".two").empty(); // item 1 的文字消失,但 li 項目符號還在,證明元素沒被移除
$("p").remove(); // 段落整個消失
$("input").val(); // 取值
$("input").val("hello world!"); // 設值
each() 回傳原本的集合,map() 則會建立一個新集合。不需要新集合時用 map,容易造成多餘的記憶體配置。
var arr = [];
$(":checkbox").each(function(index){
arr.push(this.id);
});
alert(arr.join(","));
var str = $(":checkbox").map(function() {
return this.id;
}).get().join();
alert(str);
另外要區分兩種 each:$(selector).each() 遍歷選中的元素,$.each() 則可遍歷任何陣列或物件。
$.each(["one","two","three"], function(i, l){
alert("index #" + i + ": " + l);
});
$.each({ name: "John", lang: "JS" }, function(k, v){
alert("Key: " + k + ", Value: " + v);
});
$("input").select(function(){
$("input").after("文本被選中!");
});
$("button").click(function(){
$("input").trigger("select");
});
1.6 之前 attr() 在取某些值時會回傳 property,導致結果不一致。1.6 起兩者分工明確:prop() 取 property、attr() 取 attribute。
像是 selectedIndex、tagName、nodeName、nodeType、ownerDocument、defaultChecked、defaultSelected 這些只有 property、沒有對應 attribute 的名稱,都應該用 prop()。
$("p").after($("b")); // <p>...</p><b>Hello</b>
$("p").insertAfter("#foo"); // <div id="foo">...</div><p>...</p>
$("p").before($("b")); // <b>Hello</b><p>...</p>
$("p").prepend($("b")); // <p><b>Hello</b>...</p>
$("p").append("<b>Hello</b>"); // <p>...<b>Hello</b></p>
$("p").prependTo("#foo"); // <div id="foo"><p>...</p></div>
記憶方式:
insertAfter() / after():在既有元素外側、從後面插入。insertBefore() / before():在既有元素外側、從前面插入。appendTo() / append():在既有元素內側、從後面插入。prependTo() / prepend():在既有元素內側、從前面插入。toggleClass() 有就移除、沒有就加上,切換狀態時很好用。css(name, value) 則是直接設定樣式屬性。
把這些方法的差異記清楚,讀別人的程式碼時會順暢很多,也能少寫幾段繞路的可疑寫法。