這份筆記把日常開發中最常翻閱的 jQuery 用法整理成十二個主題,適合當作速查表。
用 $() 可以透過 id、class、元素名稱、層級關係以及 DOM/XPath 條件來引用元素,回傳的是 jQuery 物件(集合物件),因此不能直接呼叫 DOM 定義的方法。
只有 jQuery 物件才能使用 jQuery 定義的方法。一般 DOM 物件可以透過 $() 轉成 jQuery 物件,例如 $(document.getElementById("msg"))。
由於 jQuery 物件本身是集合,要轉回 DOM 物件必須取出其中某一項:
$("#msg")[0]
$("div").eq(1)[0]
$("div").get()[1]
$("td")[5]
以下幾種寫法都是正確的:
$("#msg").html();
$("#msg")[0].innerHTML;
$("#msg").eq(0)[0].innerHTML;
$("#msg").get(0).innerHTML;
可用 eq(n)、get(n) 或索引。注意:eq() 回傳 jQuery 物件,get(n) 與索引回傳 DOM 元素。
$("div").eq(2).html(); // 使用 jQuery 方法
$("div").get(2).innerHTML; // 使用 DOM 屬性
$("#msg").html(); // 取得 HTML 內容
$("#msg").html("<b>new content</b>"); // 寫入 HTML,畫面顯示粗體
$("#msg").text(); // 取得純文字內容
$("#msg").text("<b>new content</b>"); // 寫入純文字,標籤會被原樣顯示
$("#msg").height(); $("#msg").height("300");
$("#msg").width(); $("#msg").width("300");
$("input").val(); $("input").val("test");
$("#msg").click(); $("#msg").click(fn);
blur、focus、select、submit 等事件同樣有這兩種呼叫形式。
$("p").each(function (i) { this.style.color = ['#f00','#0f0','#00f'][i]; });
$("tr").each(function (i) { this.style.backgroundColor = ['#ccc','#fff'][i % 2]; }); // 隔行換色
$("p").click(function () { alert($(this).html()); });
$.extend({
min: function (a, b) { return a < b ? a : b; },
max: function (a, b) { return a > b ? a : b; }
});
alert("a=10,b=20,max=" + $.max(10, 20) + ",min=" + $.min(10, 20));
每個方法呼叫後都會回傳 jQuery 物件,因此可以一路串下去:
$("p").click(function () { alert($(this).html()); })
.mouseover(function () { alert('mouse over event'); })
.each(function (i) { this.style.color = ['#f00','#0f0','#00f'][i]; });
$("#msg").css("background"); // 取得背景色
$("#msg").css("background", "#ccc"); // 設定背景為灰
$("#msg").height(300); $("#msg").width("200");
$("#msg").css({ color: "red", background: "blue" }); // 以名值對設定
$("#msg").addClass("select"); // 新增 class
$("#msg").removeClass("select"); // 移除 class
$("#msg").toggleClass("select"); // 有則移除、無則加入
$("#msg").click(function () { alert("good"); });
$("p").click(function (i) { this.style.color = ['#f00','#0f0','#00f'][i]; });
幾個自訂事件:
$("tr").hover(
function () { $(this).addClass("over"); },
function () { $(this).addClass("out"); }
);
$(fn)。
$(document).ready(function () { alert("Load Success"); });
$("p").toggle(
function () { $(this).addClass("selected"); },
function () { $(this).removeClass("selected"); }
);
$("p").trigger("click");
$("p").bind("click", function () { alert($(this).text()); });
$("p").unbind(); // 移除所有事件
$("p").unbind("click"); // 移除 click 事件
toggle() 涵蓋 hide() 與 show();slideToggle() 涵蓋 slideDown() 與 slideUp(),兩者都提供了狀態切換的能力。
$.browser.isie。$.each([0,1,2], function (i, n) { alert("Item #" + i + ": " + n); });
$.each({ name: "John", lang: "JS" }, function (i, n) { alert("Name: " + i + ", Value: " + n); });
$.extend(settings, options); // 合併後結果存於 settings
var settings = $.extend({}, defaults, options); // 不覆蓋 defaults
var a = $.map([0,1,2], function (i) { return i + 4; }); // [4,5,6]
var b = $.map([0,1,2], function (i) { return i > 0 ? i + 1 : null; }); // [2,3]
$.merge([0,1,2], [2,3,4]) // [0,1,2,3,4]$.trim(" hello, how are you? ")如果你自己也定義了 $(id),或同時使用 prototype 等也定義了 $ 的函式庫,就會發生衝突。jQuery 提供了現成的解法:
jQuery.noConflict();
// 之後一律改用 jQuery
jQuery("div p").hide();
// 其他函式庫的 $() 照常使用
$("content").style.display = 'none';
noConflict() 會把 $ 的控制權讓給最先實作它的那個函式庫。另一個常見寫法是用立即函式把 $ locally 綁回 jQuery:(function ($) { /* 這裡可以放心用 $ */ })(jQuery);