用 jQuery 操作 DOM,比原生 API 少了大量樣板程式碼。以下把日常最常用到的操作依功能分類整理,每一類都附上可直接試跑的範例,並搭配一段完整的 HTML 結構方便對照。
// 選取 ul 底下第二個 li 的文字內容(eq 的索引從 0 開始)
alert($("ul li:eq(1)").text());
// 選取 p 的 title 屬性值
alert($("p").attr("title"));
text() 類似原生的 innerText,只取純文字;html() 則類似 innerHTML,會連標籤一起取出來。兩者都可以帶參數來設值:
alert($("p").html()); // 取得值
$("p").html("change"); // 改變值
alert($("p").text()); // 取得值
$("p").text("again change"); // 改變值
// 內部追加(加到 ul 結束標籤之前)
$('ul').append("<li title='香蕉'>香蕉</li>").append("<li title='雪梨'>雪梨</li>");
// 內部前插(加到 ul 的第一個子節點之前)
$('ul').prepend("<li title='前加'>前加</li>");
// 外部追加(加到 ul 這個節點之後)
$('ul').after("<li title='後加'>後加</li>");
// 相對定位寫法:把新節點插到 p 之後/之前
$("<b>你好</b>").insertAfter("p");
$("<b>你好</b>").insertBefore("p");
// 刪除節點
$("ul :eq(1)").remove();
// 清空節點內容(保留節點本身)
$("ul :eq(2)").empty();
要注意 remove() 與 empty() 的差別:前者把元素整個移除,後者只清掉裡面的內容。
// 複製節點
$("ul li").click(function () {
// 傳入 true 表示複製時連綁定的事件一併複製
$(this).clone(true).appendTo("ul");
});
// 替換節點
$("p[title=test]").replaceWith("<strong>你最喜歡的水果是?</strong>");
// 反向寫法:
// $("<strong>你最喜歡的水果是?</strong>").replaceAll("p");
// 包裹
$("strong").wrap("<b></b>");
// 一次加上多個屬性
$("P").attr({ "title": "test", "name": "pName" });
// 移除屬性
$("p").removeAttr("title");
// class 操作
$("p").addClass("hight"); // 加上樣式
$("p").removeClass("highr"); // 移除樣式
$("p").toggleClass("another"); // 切換樣式
$("p").hasClass("higth"); // 判斷是否有該樣式
// 直接設定多組 CSS
$("p").css({ "fontSize": "40px", "background": "yellow" });
最經典的應用就是「提示文字」:輸入框未取得焦點時顯示灰色提示,取得焦點時清空,離開時若為空則把提示填回去。
$("#name").focus(function () {
if ($("#name").val() == "請輸入用戶名") {
$(this).val("");
}
}).blur(function () {
if ($("#name").val() == "") {
$(this).val("請輸入用戶名");
}
});
$("#password").focus(function () {
$("#tip").hide();
}).blur(function () {
if ($("#password").val() == "") {
$("#tip").show(200);
}
});
$("#submit").click(function () {
if ($("#name").val() == "請輸入用戶名" || $("#password").val() == "") {
$("#name").css("background", "yellow");
$("#password").css("background", "yellow");
}
});
要為下拉選單、核取方塊與單選鈕賦值,val() 都能派上用場:
$("#single").val("選擇2");
$("#multiple").val(["選擇2號", "選擇3號"]);
$(":checkbox").val(["check2", "check3"]);
$(":radio").val(["radio1"]);
若 val() 不合用,也可以直接操作 selected/checked 屬性:
$("#single :eq(2)").attr("selected", true);
$("[value=radio2]:radio").attr("checked", true);
// children():取得所有直接子元素
$("#btnShow").click(function () {
for (var i = 0; i < $("body").children().length; i++) {
$("#body").append($("body").children()[i].innerHTML);
}
});
// next():取得緊接在後的同層元素
alert($("ul li").next().text());
// prev():取得緊接在前的那一個同層元素
alert($("li[title=菠蘿]").prev().text());
// siblings():取得所有同層元素
for (var i = 0; i < $("p").siblings().length; i++) {
$("#subling").append($("p").siblings()[i].innerHTML);
}
// closest():由目前元素往上找最近的符合條件的祖先
$(document).bind("click", function (e) {
$(e.target).closest("li").css("color", "red");
});
closest() 在事件委派中特別有用:不管使用者點的是 li 裡面的哪個子元素,都能準確找到那個 li。
// offset():相對於目前視窗的偏移量,回傳 top 與 left
alert("top=" + $("P").offset().top + ";" + "left=" + $("P").offset().left);
// position():相對於最近的、樣式設為 relative 或 absolute 的祖先節點的偏移
alert("top=" + $("P").position().top + ";" + "left=" + $("P").position().left);
// scrollTop() / scrollLeft():捲軸距頂端與左端的距離
alert("scrolltop=" + $("P").scrollTop() + ";" + "scrollleft=" + $("P").scrollLeft());
offset() 與 position() 很容易搞混,記法很簡單:offset 是「從畫面(視窗)看」,position 是「從定位父元素看」。
<body> <p>test</p> <p id="p" title="test">你喜歡的蘋果是?</p> <ul> <li title="蘋果">蘋果</li> <li title="橘子">橘子</li> <li title="菠蘿">菠蘿</li> </ul> <input type="button" id="show" value="show" /> <br/><br/><br/> <form id="form1" action="#"> <div> <input type="text" id="name" value="請輸入用戶名"><br/> <input type="password" id="password" value=""><br/> <div id="tip" style="display:none"><font color="red">請輸入密碼</font></div><br/> <input type="button" id="submit" value="提交"/> </div> </form> <br/> <form id="form2" action="#"> <select id="single"> <option value="選擇1號">選擇1號</option> <option value="選擇2號">選擇2號</option> <option value="選擇3號">選擇3號</option> </select> <select id="multiple" multiple="multiple" style="height:120px"> <option selected="selected">選擇1號</option> <option value="選擇2號">選擇2號</option> <option value="選擇3號">選擇3號</option> <option value="選擇4號">選擇4號</option> <option selected="selected">選擇5號</option> </select> <input type="checkbox" value="check1"/>多選1 <input type="checkbox" value="check2"/>多選2 <input type="checkbox" value="check3"/>多選3 <input type="checkbox" value="check4"/>多選4 <input type="radio" name="radio" value="radio1"/> 單選1 <input type="radio" name="radio" value="radio2"/> 單選2 <input type="radio" name="radio" value="radio3"/> 單選3 <br/> <input type="button" id="btnShow" value="顯示body"/> <br/> <div id="body"></div> <div id="subling"></div> </form> </body>
屬性的新舊寫法。在 jQuery 1.6 之後,attr() 與 prop() 有了明確分工:像 checked、selected、disabled 這類「目前的狀態」應該用 prop(),而 title、href、id 這類「HTML 裡寫死的屬性」才用 attr()。範例中 attr("checked", true) 在新版 jQuery 上不會有預期效果,請改用 prop("checked", true)。
提示文字的正確做法。上面用「比對字串是否等於提示文字」來判斷使用者有沒有輸入,有個明顯破綻:如果使用者真的輸入「請輸入用戶名」這五個字,就會被誤判為空。正式專案請改用 placeholder 屬性,或使用 data-* 屬性保存提示文字與實際值。
事件綁定的時機。範例中的 .click()、.hover()、.bind() 都已被視為舊寫法,現在建議統一使用 .on();若要綁定「未來才出現的元素」,更要用事件委派:$(document).on('click', '.dynamic-btn', handler)。