jQuery 的 API 數量龐大,但日常開發真正高頻使用的其實集中在幾類。這篇把事件綁定、視覺效果、元素篩選、文件操作、Ajax 與工具函式整理成一份帶範例的速查筆記。
ready(fn)——在 DOM 就緒、可讀取與操作時立即執行。它讓程式不必等圖片下載完就能動手,是絕大多數 jQuery 程式的起點。
$(document).ready(function(){
// Your code here...
});
bind(type, [data], fn)——為符合條件的每個元素綁定事件處理器。
$("p").bind("click", function(){
alert( $(this).text() );
});
toggle(fn, fn)——每次點擊交替執行兩個函式,第一次觸發第一個,再點觸發第二個。
$("td").toggle(
function () { $(this).addClass("selected"); },
function () { $(this).removeClass("selected"); }
);
至於 click()、focus()、keydown() 這類簡寫,都是 bind 的快捷方式,實務上更常看到。
版本提醒:bind 與 toggle(fn, fn) 在 jQuery 1.7 之後已被 on() 取代,1.9 起移除。新專案請用 $(document).on('click', 'p', fn) 進行事件委派。
addClass / removeClass——動態增刪 class,最常見的樣式切換手法。經典的雙色表格就是這樣做的:
$(".stripe tr").mouseover(function(){ $(this).addClass("over"); });
$(".stripe tr").mouseout (function(){ $(this).removeClass("over"); });
css(name, value)——直接設定單一樣式屬性:
$("p").css("color", "red");
show / hide / fadeIn / fadeOut / slideUp / slideDown——一組動態效果函式,都可接受 speed 與 callback 參數:
$("#btnShow").bind("click", function(event){ $("#divMsg").show(); });
$("#btnHide").bind("click", function(event){ $("#divMsg").hide(); });
// 帶速度與回呼
$("#divMsg").show("slow", function(){
alert("顯示完成");
});
animate(params, [duration], [easing], [callback])——自製動畫的核心函式,功能最強,可串接連續呼叫:
$("#box").animate({ width: "300px", opacity: 0.5 }, 800, "linear");
map(callback)——把一組元素轉為另一個陣列,可用來收集值、屬性或樣式:
<p><b>Values: </b></p>
<form>
<input type="text" name="name" value="John" />
<input type="text" name="password" value="password" />
<input type="text" name="url" value="https://ejohn.org/" />
</form>
$("p").append( $("input").map(function(){
return $(this).val();
}).get().join(", ") );
// 結果:<p>John, password, https://ejohn.org/</p>
注意結尾的 .get():它把 jQuery 物件轉為真正的陣列,才能使用 join。
find(expr)——尋找目前元素的後代中符合條件的:
<p><span>Hello</span>, how are you?</p>
$("p").find("span"); // 結果:[ <span>Hello</span> ]
attr(key, value)——取得或設定屬性;元素若無該屬性則回傳 undefined:
<img /><img />
$("img").attr("src", "test.jpg");
html() / text() / val()——分別取得或設定 HTML 內容、純文字、以及表單的值:
<div><p>Hello</p></div>
$("div").html(); // 結果:<p>Hello</p>
wrap(html)——用指定結構把所有符合的元素包起來,且不破壞原文件的語意:
<p>Test Paragraph.</p>
$("p").wrap("<div class='wrap'></div>");
// 結果:<div class="wrap"><p>Test Paragraph.</p></div>
empty()——刪除符合元素集合中的所有子節點:
<p>Hello, <span>Person</span> <a href="#">and person</a></p>
$("p").empty();
// 結果:<p></p>
load(url, [data], [callback])——載入遠端 HTML 並插入 DOM,是最簡潔的 Ajax 用法:
$("#feeds").load("feeds.aspx", { limit: 25 }, function(){
alert("The last 25 entries in the feed have been loaded");
});
serialize()——把表單內容序列化為字串,直接可作為查詢參數:
<p id="results"><b>Results: </b> </p>
<form>
<select name="single">
<option>Single</option>
<option>Single2</option>
</select>
<select name="multiple" multiple="multiple">
<option selected="selected">Multiple</option>
<option>Multiple2</option>
<option selected="selected">Multiple3</option>
</select><br/>
<input type="checkbox" name="check" value="check1" /> check1
<input type="checkbox" name="check" value="check2" checked="checked" /> check2
<input type="radio" name="radio" value="radio1" checked="checked" /> radio1
<input type="radio" name="radio" value="radio2" /> radio2
</form>
$("#results").append( "<tt>" + $("form").serialize() + "</tt>" );
// 輸出:single=Single&multiple=Multiple&multiple=Multiple3&check=check2&radio=radio1
jQuery.each(obj, callback)——通用遍歷,陣列與物件皆可:
$.each([0, 1, 2], function(i, n){
alert("Item #" + i + ": " + n);
});
$.each({ name: "John", lang: "JS" }, function(i, n){
alert("Name: " + i + ", Value: " + n);
});
jQuery.makeArray(obj)——把類陣列物件轉為真正的陣列:
<div>First</div><div>Second</div><div>Third</div><div>Fourth</div>
var arr = jQuery.makeArray(document.getElementsByTagName("div"));
jQuery.trim(str)——移除字串起始與結尾的空白。
$.trim(" hello "); // "hello"
這些方法的觀念至今仍然通用,但請留意時代差異:bind 已被 on 取代、attr("checked") 切換勾選狀態需改用 prop()、trim 可用原生的 String.prototype.trim()。
而若是在新專案中,fetch 已能取代大部分 Ajax 需求,classList 取代 add/removeClass,Element.animate() 取代 jQuery animate。理解 jQuery 的設計思維仍有價值——它讓「選擇元素、對它做事」這件事變得直觀,而這個直觀正是後來許多 API 設計的榜樣。