上一篇整理了選擇器與基礎語法,本文接著補完開發中最常遇到的實戰環節。
// 取得文本框的值,等同 txt.value
var val = $("#txt").val();
// 設定值,等同 txt.value = "123123"
$("#txt").val("這是 val 設置的值");
規則還是一樣:不傳參數是讀,傳參數是寫。
// 設定單個屬性
$("a").attr("title", "傳智播客");
// 設定多個屬性
$("a").attr({ "title": "傳智播客", "data-abc": "自定義屬性" });
// 讀取屬性
var t = $("a").attr("title");
$(id/class名).attr("checked", true);
注意:checked、selected、disabled 必須使用 prop()。
prop() 用來影響 DOM 元素的動態狀態,而不是改寫 HTML 標籤上的靜態屬性。混用會出現「畫面看起來改了,但 .attr() 讀出來還是舊值」這類難以察覺的 bug。
var txt = $("div").text(); // 取得文字
$("div").text("動態設置的內容"); // 設定文字
alert($("div").html()); // 取得 HTML 片段
var h = $("div").height(); // 回傳數值,可直接參與運算
var h2 = $("div").css("height"); // 回傳 "200px" 這樣的字串
$("div").height(500);
$("div").height("500px");
height() 回傳 number、css("height") 回傳 string,需要計算時一律用前者。
var offset = $("div").offset(); // {top: 29, left: 8}
$("div").offset({ top: 200, left: 400 });
關鍵細節:設座標時,若該元素沒有定位或定位為預設的 static,offset() 會自動把它的定位改成 position: relative,否則位移不會生效。
$("button").bind("click mouseenter", function () {});
$("button").bind({ click: function () {}, mouseenter: function () {} });
缺點很明確:無法為動態產生的元素綁定事件,因為綁定當下那些元素還不存在。
$("div").delegate("p", "click", function () {
var txt = $(this).text();
});
三個參數分別是:實際要觸發事件的元素選擇器、事件名稱、事件處理函式。事件在頁面載入時就綁定好,執行則發生在對應互動的瞬間(click 是點擊時、mouseenter 是滑鼠移入時)。因為監聽掛在父元素上,所以後來才插進来的子元素同樣有效。
$("div").on("click", ".cls", function () {
var txt = $(this).text();
});
on() 是 jQuery 1.7 之後的統一寫法,第二個參數傳入選擇器即等同 delegate 的代理效果,是目前的標準做法。
用 unbind:
$("button").eq(0).unbind("click mouseenter");
$("button").eq(0).undelegate();
用 off:
$("#btn").off("click mouseenter"); // 解除指定事件
$("div").off(); // 解除全部
$("div").off("click", "**"); // 只解除透過代理綁定的事件
注意:解綁的對象必須是綁定時的那個元素,找錯元素不會有任何效果,也不會報錯,這是常見的排查盲點。
屬於瀏覽器預設行為的有:a 標籤的跳轉、文本框取得焦點等。
$("#txt").trigger("focus"); // 觸發事件並執行瀏覽器預設行為
$("#txt").triggerHandler("focus"); // 只觸發事件,不執行預設行為
另外,事件物件上的 target 是實際觸發事件的元素,currentTarget 才是綁定事件的元素,兩者在事件代理時不相同,這點在除錯時特別容易混淆。
e.preventDefault(); // 阻止瀏覽器預設行為 e.stopPropagation(); // 阻止事件冒泡
$("li").parent("ul").parent("div").siblings("div").children("div").html("內容");
鏈式能成立,是因為每個方法最後都 return this。也因此有個重要結論:只有「設定」操作能把鏈條延續下去,因為「取得」操作必須回傳取到的值,無法回傳 this。
end(); // 結束最近一次篩選操作,回到篩選前的狀態
$("div").css("color", "red"); // 設定:所有符合的元素都會被改
$("div").css("color"); // 取得:只回傳第一個元素的值
隱式迭代指的是方法內部會自動遍歷所有匹配元素,不必自己寫迴圈。而取值時大部分情況只回傳第一個。
多數情況不需要,隱式迭代已經足夠。但如果每個元素要做不同處理,就必須動用 each:
$("li").each(function (index, ele) {
// index 是索引,ele 是元素本身(DOM 物件)
$(ele).css("opacity", (index + 1) / 10);
});
jQuery 佔用了 $ 與 jQuery 兩個變數。若同頁面還引入其他用到 $ 的函式庫(或不同版本的 jQuery),就會衝突。
var j = $.noConflict();
// 此後 jQuery 釋放對 $ 的控制權,只能用 jQuery 呼叫其方法
j("#msg").text("ok");
使用步驟:先引入 jQuery 本體,再引入插件檔案。
常見第三方插件:如 jQuery.color.js 可補上 animate() 對背景色的動畫支援(原生的 animate 只接受數值型屬性)。
製作插件:
$.pluginName = function () {}; // 擴充全域 jQuery 函式
$.fn.pluginName = function () {}; // 擴充 jQuery 實例方法(最常用)
官方教學:https://learn.jquery.com/plugins/basic-plugin-creation/
jQuery UI 是由 jQuery 官方維護的 UI 元件庫,特別適合開發網站管理後台。引入順序為:樣式檔 → jQuery 本體 → jQuery UI 腳本。
<link rel="stylesheet" href="plugins/jquery-ui.css"/> <script src="jquery-1.12.2.js"></script> <script src="plugins/jquery-ui.js"></script>
官方 API 文件:https://api.jqueryui.com/category/all/
順序不能顛倒,因為 jQuery UI 依賴 jQuery 已先在全域環境中就位。