隨著 Web 2.0 與 Ajax 思想在互聯網上的快速傳播,一批優秀的 JavaScript 框架脫穎而出——Prototype、YUI、jQuery、mootools、Bindows 以及國內的 JSVM 等。把它們引入項目,能讓開發者從繁雜的 JS 細節中解脫出來,把注意力放回功能需求本身。
jQuery 是繼 Prototype 之後又一個優秀的 JavaScript 框架,由 John Resig 於 2006 年初創建,極大簡化了 JavaScript 與 Ajax 編程。有個流傳很廣的比喻:Prototype 就像 Java,而 jQuery 就像 Ruby。
官方站點 https://jquery.com/,中文站點 https://jquery.org.cn/。
在需要使用 jQuery 的頁面中引入 js 文件即可:
<script type="text/javascript" src="js/jquery.js"></script>
通過 $() 引用元素的方式包括 id、class、元素名、層級關係以及 DOM 或 XPath 條件等,返回的是 jQuery 對象(集合對象),不能直接調用 DOM 定義的方法。
只有 jQuery 對象才能使用 jQuery 定義的方法,兩者有本質區別,調用時務必分清。
普通 DOM 對象可以通過 $() 轉成 jQuery 對象:
$(document.getElementById("msg")); // 此時可以使用 jQuery 的方法
反之,由於 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()、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 等事件同樣具備這兩種調用形式。
對於 jQuery 返回的集合,無需自己遍歷,框架已提供 each()、filter()、map() 等便捷方法。
$.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));
$("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"); // 切換 class
無需在 HTML 元素上直接寫事件,可以直接為 jQuery 對象添加:
$("#msg").click(function() { alert("good"); });
$("p").click(function(i) { this.style.color = ['#f00', '#0f0', '#00f'][i]; });
幾個常用的自定義事件:
hover(fn1, fn2) —— 模仿懸停事件,移入觸發第一個函數,移出觸發第二個:
$("tr").hover(
function() { $(this).addClass("over"); },
function() { $(this).addClass("out"); }
);
ready(fn) —— DOM 就緒時執行。不同於 onload 需要等圖片等資源全部加載完畢,ready 只要 HTML 下載完成即觸發,與 $(fn) 等價:
$(document).ready(function() { alert("Load Success"); });
toggle(evenFn, oddFn) —— 每次點擊輪番切換調用的函數:
$("p").toggle(
function() { $(this).addClass("selected"); },
function() { $(this).removeClass("selected"); }
);
trigger(eventType) —— 觸發指定類型事件:
$("p").trigger("click"); // 觸發所有 p 元素的 click
bind / unbind —— 事件的綁定與反綁定:
$("p").bind("click", function() { alert($(this).text()); });
$("p").unbind(); // 刪除所有事件
$("p").unbind("click"); // 刪除 click 事件
toggle() 與 slideToggle() 提供狀態切換能力:前者等價於 hide() 與 show() 的組合,後者等價於 slideDown() 與 slideUp() 的組合。
$.browser —— 檢測瀏覽器類型,有效參數 safari、opera、msie、mozilla。
$.each(obj, fn) —— 通用迭代函數,可替代 for 循環:
$.each([0, 1, 2], function(i, n) {
alert("Item #" + i + ": " + n);
});
// 等價於
var tempArr = [0, 1, 2];
for (var i = 0; i < tempArr.length; i++) {
alert("Item #" + i + ": " + tempArr[i]);
}
也能處理 JSON 對象:
$.each({ name: "John", lang: "JS" }, function(i, n) {
alert("Name: " + i + ", Value: " + n);
});
// 輸出:Name:name, Value:John / Name:lang, Value:JS
$.extend(target, prop1, propN) —— 用一個或多個對象擴展目標對象,這是 jQuery 實現「繼承」的方式:
$.extend(settings, options); // 合並後結果保存在 settings
var settings = $.extend({}, defaults, options); // 不覆蓋 defaults 內容
$.map(array, fn) —— 數組映射:
var tempArr = $.map([0, 1, 2], function(i) { return i + 4; });
// tempArr 內容為 [4, 5, 6]
var tempArr = $.map([0, 1, 2], function(i) { return i > 0 ? i + 1 : null; });
// tempArr 內容為 [2, 3](返回 null 的項會被過濾掉)
$.merge(arr1, arr2) —— 合並數組並去重:
$.merge([0, 1, 2], [2, 3, 4]); // 返回 [0, 1, 2, 3, 4]
$.trim(str) —— 刪除字符串兩端空白:
$.trim(" hello, how are you? "); // 返回 "hello, how are you?"
很多時候我們自己定義了 $(id) 方法,或者項目裡同時引入了 Prototype 這類同樣佔用 $ 的庫,就會發生衝突。jQuery 提供了專門的解法:
jQuery.noConflict();
// 開始使用 jQuery
jQuery("div p").hide();
// 使用其他庫的 $()
$("content").style.display = 'none';
調用 jQuery.noConflict() 後,$ 的控制權會讓渡給第一個實現它的庫,此後只需把 jQuery 相關代碼中的 $ 換成 jQuery 即可。常見用法:
jQuery("p").each(function(i) { this.style.color = ['#f00', '#0f0', '#00f'][i]; });
jQuery("tr").each(function(i) { this.style.backgroundColor = ['#ccc', '#fff'][i % 2]; });
jQuery("p").click(function() { alert(jQuery(this).html()); });
另一種更常用的做法是用立即執行函數把 $ 局部化:
(function($) {
$("p").hide(); // 這裡的 $ 就是 jQuery
})(jQuery);
本文總結的語法基於 jQuery 早期版本。需要注意的是:$.browser 已在 1.9 移除,live() 也在 1.9 移除,bind()/unbind()/delegate() 均已棄用,toggle(fn1, fn2) 的雙函數形式在 1.9 也已移除。新項目請統一使用 on() / off() 進行事件綁定,並改用特性檢測代替瀏覽器嗅探。