jQuery 最大的價值,是把繁瑣的原生 DOM 操作收斂成一行短方法。以下依使用情境分類整理,方便隨手翻查。
$("div") // 依標籤名選取,等同 document.getElementsByTagName
$("#ID") // 依 id 選取單一元素,等同 document.getElementById
$(".cls") // 依 class 選取
$("标签.class") // 標籤 + class 複合條件
$("div #ID") // 在某元素內部再往下找
$("#ID #ID") // 以 id 為錨點向下尋找後代
jQuery 大量採用「同一方法兼任 getter 與 setter」的設計:不傳參數是讀,傳參數是寫。
$("#ID").val(); // 取得表單值
$("#ID").val("abc"); // 設定表單值
$("#ID").text(); // 取得純文字,等同 innerText
$("#ID").text("abc"); // 寫入純文字
$("#ID").html(); // 取得 HTML 片段,等同 innerHTML
$("#ID").html("<b>abc</b>"); // 寫入並解析為標籤
$("#ID").hide();
$("#ID").show();
$("#ID").css("color", "red");
$("#ID").css({ color: "red", "font-size": "20px" });
$("#ID").addClass("active");
$("#ID").removeClass("active");
$("form#frmMain").find("#ne").css("border", "1px solid #0f0").end()
.find("#chenes").css("border-top", "3px dotted #00f").end();
$("#ID").load("*.html"); // 載入外部文件並插入
end() 的作用是回到鏈條上一層的集合,讓後續操作繼續作用在外層元素上,這是 jQuery 鏈式語法能維持可讀性的關鍵。
$(document).ready(function () { /* DOM 就緒後執行 */ });
$("#description").mouseover(function () { /* 滑鼠移入 */ });
$.ajax({
url: "Result.aspx", // 請求位址
type: "get", // get 或 post
dataType: "html", // 預期回應格式:xml / html / script / json
data: "chen=h", // 送出的參數(get 專用寫法)
timeout: 3000, // 逾時毫秒數
success: function (msg) { $("#stats").text(msg); },
error: function (msg) { $("#stats").text(msg); }
});
// 簡寫版本
$.get("Result.aspx", { chen: "測試", age: "25" }, function (data) {
alert("Data Loaded: " + data);
});
$("#testSelect option:selected").text();
$("#testSelect").find("option:selected").text();
$("#testSelect").val();
在 DOM 樹解析完成、可以安全操作節點時立刻執行。由於不必等待圖片等外部資源,回應速度明顯優於 window.onload。
$("p").bind("click", function () { alert($(this).text()); });
$("td").toggle(
function () { $(this).addClass("selected"); },
function () { $(this).removeClass("selected"); }
);
第一次點擊觸發第一個函式,再次點擊觸發第二個,以此輪替。做「點一下展開、再點一下收合」這類雙態切換很順手。
$(".stripe tr").hover(
function () { $(this).addClass("over"); },
function () { $(this).removeClass("over"); }
);
$("p").css("color", "red");
$("#divMsg").show("slow", function () { /* 顯示後回調 */ });
$("#divMsg").hide();
$("#divMsg").slideUp();
$("#divMsg").slideDown();
$("#divMsg").fadeIn();
$("#divMsg").fadeOut();
animate() 則是自訂動畫的核心,能對任意數值型 CSS 屬性做補間,且可以串接連續播放:
$("#box").animate({ width: "300px", opacity: 0.5 }, 800);
$("p").append($("input").map(function () {
return $(this).val();
}).get().join(", "));
把一組元素的值、屬性或樣式映射成新陣列,常用來快速彙整表單內容。
$("p").find("span"); // 找出目前元素底下所有符合條件的後代
$("img").attr("src", "test.jpg"); // 讀寫屬性
$("div").html(); // 讀寫 HTML 內容
$("p").wrap("<div class='wrap'></div>"); // 在外層包上結構
$("p").empty(); // 清空所有子節點
wrap() 特別好用:它能在不破壞原有語意的前提下補上容器結構,是調整版型時的救命工具。
$("#feeds").load("feeds.aspx", { limit: 25 }, function () {
alert("已載入最近 25 筆");
});
$("form").serialize(); // 將表單內容序列化為查詢字串,直接丟給 Ajax
$.each([0, 1, 2], function (i, n) { alert("Item #" + i + ": " + n); });
$.each({ name: "John", lang: "JS" }, function (k, v) { alert(k + " = " + v); });
var arr = $.makeArray(document.getElementsByTagName("div")); // 類陣列轉真陣列
$.trim(" hello "); // 去除前後空白
把這些方法記熟,日常九成的 DOM 腳本都能用一兩行解決。真正需要背的是「同一方法兼任讀寫」這個設計慣例,理解之後整套 API 都能推導出來。