把 jQuery 最常用的函數依用途分門別類整理如下,搭配簡短範例,當成開發時的速查表使用。
$(document).ready(function(){
// Your code here...
});
它能大幅提高 Web 應用程式的反應速度:在 DOM 載入就緒、可以讀取並操作時立即執行綁定的函數。實務上絕大多數 JavaScript 邏輯都該放在這裡,而不是等 window.onload。
$("p").bind("click", function(){
alert( $(this).text() );
});
為每一個相符元素的特定事件(如 click)綁定一個事件處理函式,扮演事件監聽者的角色。
$("td").toggle(
function () {
$(this).addClass("selected");
},
function () {
$(this).removeClass("selected");
}
);
每次點擊時切換要呼叫的函數:第一次點擊觸發第一個,再次點擊同一元素則觸發第二個。做多狀態切換時很好用。(click()、focus()、keydown() 這類基本事件這裡不再贅述。)
$(".stripe tr").mouseover(function(){
$(this).addClass("over");
}).mouseout(function(){
$(this).removeClass("over");
});
為元素加上或移除樣式,做出動態的外觀變化——上面這個就是滑鼠移過時的表格雙色效果。
$("p").css("color","red");
為相符元素設定單一樣式屬性的值,感覺上和 addClass() 有點類似,但它是直接寫入 inline style。
$("#btnShow").bind("click",function(event){ $("#divMsg").show() });
$("#btnHide").bind("click",function(event){ $("#divMsg").hide() });
幾個最常用的動態效果函式。它們都能接受參數:show(speed, [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> ]
把一組元素轉換成另一個陣列——值、屬性、CSS 樣式或其他任何形式都可以。注意結尾的 .get():它把 jQuery 物件轉成真陣列,才能使用 join()。
<p><span>Hello</span>, how are you?</p>
$("p").find("span") // [ <span>Hello</span> ]
搜尋所有符合表達式的後代元素,是往下鑽取的好方法。
<img/><img/>
$("img").attr("src","test.jpg");
取得或設定相符元素的屬性值。這個方法能方便地從第一個相符元素取得屬性;若元素沒有該屬性,會回傳 undefined。操作 HTML 標記時必備。
<div><p>Hello</p></div>
$("div").html(); // <p>Hello</p>
取得或設定相符元素的 HTML 內容。同類型的還有 text()(取得所有相符元素的文字內容)與 val()(取得表單元素的當前值)。三者相似,常用於內容操作。
<p>Test Paragraph.</p>
$("p").wrap("<div class='wrap'></div>");
// <div class='wrap'><p>Test Paragraph.</p></div>
把所有相符元素用其他結構標記包裹起來。這種包裝對於在文件中插入額外結構最有用,而且不會破壞原始文件的語義品質,能很靈活地改造 DOM。
<p>Hello, <span>Person</span> <a href="#">and person</a></p>
$("p").empty(); // <p></p>
刪除相符元素集合中所有的子節點(元素本身保留)。
url(String):待載入的 HTML 網頁網址。data(Map):(選用)發送至伺服器的 key/value 資料。callback(Callback):(選用)載入成功時的回呼函數。$("#feeds").load("feeds.aspx", {limit: 25}, function(){
alert("The last 25 entries in the feed have been loaded");
});
載入遠端 HTML 並插入 DOM,這是最常用也最直接有效的方式。
<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>" );
把表單內容序列化成查詢字串,專門為了 Ajax 請求而生。它會自動處理核取方塊與單選鈕的選取狀態,比自己手動拼字串可靠得多。
$.each( [0,1,2], function(i, n){
alert( "Item #" + i + ": " + n );
}); // 遍歷陣列
$.each( { name: "John", lang: "JS" }, function(i, n){
alert( "Name: " + i + ", Value: " + n ); // 遍歷物件
});
通用遍歷方法,可用於物件與陣列。
<div>First</div><div>Second</div>
<div>Third</div><div>Fourth</div>
var arr = jQuery.makeArray(document.getElementsByTagName("div"));
把類陣列物件(array-like,例如 NodeList)轉成真陣列,讓我們能在兩者之間靈活轉換,並使用陣列的原生方法。
去掉字串起始與結尾的空白,處理使用者輸入前的基本步驟。