這是一篇整理性質的速查筆記,把 jQuery 最常使用的方法依功能分類條列,附上簡短說明與範例,方便開發時快速查找。
$("p").addClass(css中定義的樣式類型); // 為元素添加樣式
$("img").attr({src:"test.jpg", title:"test Image"}); // 添加屬性/值,參數為 map
$("input").attr({"checked", "checked"}); // 設定 checked 屬性
$("img").attr("title", function() { return this.src }); // 屬性值取自函式回傳
$("元素名稱").html(); // 取得元素內的內容
$("元素名稱").html("<b>new stuff</b>"); // 設定元素內容
$("元素名稱").removeAttr("屬性名稱"); // 刪除指定屬性及其值
$("元素名稱").removeClass("class"); // 刪除指定樣式
$("元素名稱").text(); // 取得元素的純文字
$("元素名稱").text(value); // 設定文字內容
$("元素名稱").toggleClass(class); // 有則移除、無則加入
$("input元素名稱").val(); // 取得 input 的值
$("input元素名稱").val(value); // 設定 input 的值
實務上要留意 html() 與 text() 的差別:前者會解析 HTML 標籤,後者會把標籤當純文字處理。若內容來自使用者輸入,用 text() 才能避免 XSS。
$("元素").after(content); // 在匹配元素後面插入內容
$("元素").append(content); // 把 content 作為子內容接在最後
$("元素").appendTo(content); // 把元素附加到 content 之後
$("元素").before(content); // 與 after 相反
$("元素").clone(布爾表達式); // 克隆元素,表達式為真時連事件一起複製
$("元素").empty(); // 清空元素內容
$("元素").insertAfter(content); // 把元素插入到 content 之後
$("元素").insertBefore(content); // 把元素插入到 content 之前
$("元素").prepend(content); // 把 content 放到元素最前面
$("元素").prependTo(content); // 把元素放到 content 最前面
$("元素").remove(); // 刪除所有匹配元素
$("元素").remove("exp"); // 刪除含有 exp 的元素
$("元素").wrap("html"); // 用 html 包圍元素
$("元素").wrap(element); // 用 element 包圍元素
clone(true) 會連綁定的事件一起複製,這在需要複製互動元件時很實用,但也要注意它會複製事件而非引用同一個處理器。
add(expr) // 在當前集合上增加新的匹配元素
children(expr) // 取得每個元素的第一層子元素集合
contains(str) // 篩選包含指定文字的元素
end() // 回到上一次 find() 或 parents() 之前的 jQuery 物件
filter(expr) // 從現有集合中篩選
find(expr) // 在現有集合的子節點中尋找
is(expr) // 判斷集合中是否至少有一個元素符合 expr
next(expr) // 取得緊接在後的兄弟元素
not(el) // 從集合中排除符合條件的元素
parent(expr) // 取得唯一父元素
parents(expr) // 取得所有祖先元素
prev(expr) // 取得前一個兄弟元素
siblings(expr) // 取得所有兄弟元素
$(document).ready(function() {
$("div").css("border", "2px solid red")
.add("p") // 把 p 元素也加入集合
.css("background", "yellow"); // div 與 p 都會套用黃底
});
$("#div1").find("p").hide().end().hide()
第一個 hide() 作用於 p 標籤,end() 結束對 p 的參照並回到 #div1,因此第二個 hide() 作用於 #div1。若不加 end(),兩個 hide 都會作用在 p 上。
這兩個方法很容易搞混,用一個例子說明:
<div class="css">
<p class="rain">測試1</p>
</div>
<div class="rain">
<p>測試2</p>
</div>
var $find = $("div").find(".rain");
alert($find.html()); // 輸出:測試1
var $filter = $("div").filter(".rain");
alert($filter.html()); // 輸出:測試2
差別在於作用範圍:find() 在 div 的子節點裡尋找 class 為 rain 的元素;filter() 則是篩選 div 本身中 class 為 rain 的那些。一個對子集操作,一個對自身集合篩選。
$(html).appendTo("body") // 相當於在 body 中寫入 html
$(elems) // 取得 DOM 上的元素
$(function(){ ... }); // DOM 就緒後執行
$("div > p").css("border", "1px solid gray"); // 查找 div 的直接子節點 p
$("input:radio", document.forms[0]) // 在第一個表單中查找單選按鈕
jQuery.extend(object)——擴充 jQuery 類本身,為類添加靜態方法:
jQuery.extend({
min: function(a, b) { return a < b ? a : b; },
max: function(a, b) { return a > b ? a : b; }
});
// 呼叫
$.min(3, 4); // 回傳 3
jQuery.fn.extend(object)——為 jQuery 物件添加方法,本質是擴充 jQuery.prototype:
$.fn.extend({
alertWhileClick: function() {
$(this).click(function() {
alert($(this).val());
});
}
});
// 呼叫
$("#input1").alertWhileClick();
// 範例一
$("span").click(function() {
$("li").each(function() {
$(this).toggleClass("example");
});
});
// 範例二:可提前跳出
$("button").click(function() {
$("div").each(function(index, domEle) {
$(domEle).css("backgroundColor", "yellow");
if ($(this).is("#stop")) {
$("span").text("Stopped at div index #" + index);
return false; // 回傳 false 可跳出迴圈
}
});
});
ready(fn) // DOM 就緒後執行,注意 body 不能有 onload,否則不執行
bind(type, [data], fn) // 為每個匹配元素綁定事件處理器
one(type, [data], fn) // 同上,但每個元素只執行一次
trigger(type, [data]) // 在每個匹配元素上觸發指定事件
triggerHandler(type, [data]) // 觸發事件並取消瀏覽器預設行為
unbind([type], [data]) // 移除綁定的事件
hover(over, out) // 滑鼠移入執行 over,移出執行 out
toggle(fn, fn) // 第一次點擊執行第一個函式,第二次執行第二個
$('#myBtn').bind("click", function() {
alert('click');
});
// 傳入額外資料
function handler(event) { alert(event.data.foo); }
$("p").bind("click", {foo: "bar"}, handler);
// 觸發時帶參數
$("p").click(function(event, a, b) {
// 普通點擊時 a 和 b 是 undefined
// 用下面的 trigger 觸發時,a 為 "foo",b 為 "bar"
}).trigger("click", ["foo", "bar"]);
var foo = function() { /* 處理事件 */ };
$("p").bind("click", foo);
$("p").unbind("click", foo); // 只移除 foo 這個處理器
$("p").unbind(); // 移除所有事件
$("p").unbind("click"); // 移除所有 click 事件
blur, focus, load, resize, scroll, unload, click, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, error
補充:jQuery 不支援 form 元素的 reset 事件。另外 focus/blur 那組範例展示了常見的搜尋框提示文字做法:
$("#in").focus(function() {
if ($("#in").val() == '關鍵字') { $("#in").val(""); }
}).blur(function() {
if ($("#in").val() == '') {
$("#in").val("關鍵字").css("color", "#ccc");
}
});
load(url, [data], [callback]) // 載入遠端 HTML 到 DOM 節點
jQuery.get(url, [data], [callback])
jQuery.getJSON(url, [data], [callback])
jQuery.getScript(url, [callback])
jQuery.post(url, [data], [callback], [type])
jQuery.ajaxSetup(options) // 全域設定
// load
$("#feeds").load("feeds.html");
$("#feeds").load("feeds.php", {limit: 25}, function() {
alert("The last 25 entries in the feed have been loaded");
});
// get
$.get("test.cgi", { name: "John", time: "2pm" }, function(data) {
alert("Data Loaded: " + data);
});
// getJSON
$.getJSON("test.js", { name: "John", time: "2pm" }, function(json) {
alert("JSON Data: " + json.users[3].name);
});
// getScript
$.getScript("test.js", function() {
alert("Script loaded and executed.");
});
// 請求完成後
$("#msg").ajaxComplete(function(request, settings) {
$(this).append("<li>Request Complete.</li>");
});
// 請求失敗後
$("#msg").ajaxError(function(request, settings) {
$(this).append("<li>Error requesting page " + settings.url + "</li>");
});
// 請求送出時
$("#msg").ajaxSend(function(evt, request, settings) {
$(this).append("<li>Starting request at " + settings.url + "</li>");
});
// 請求開始但未激活時,顯示 loading
$("#loading").ajaxStart(function() { $(this).show(); });
// 所有請求都結束時,隱藏 loading
$("#loading").ajaxStop(function() { $(this).hide(); });
// 請求成功完成時
$("#msg").ajaxSuccess(function(evt, request, settings) {
$(this).append("<li>Successful Request!</li>");
});
// 序列化成查詢字串
function showValues() {
var str = $("form").serialize();
$("#results").text(str);
}
$(":checkbox, :radio").click(showValues);
$("select").change(showValues);
showValues();
// 序列化成 JSON 陣列
function showValues() {
var fields = $(":input").serializeArray();
$("#results").empty();
jQuery.each(fields, function(i, field) {
$("#results").append(field.value + " ");
});
}
show() / show(speed, [callback]) // 顯示隱藏元素
hide() / hide(speed, [callback]) // 隱藏元素
toggle() // 切換可見狀態
slideDown(speed, [callback]) // 向下滑動顯示(只改變高度)
slideUp(speed, [callback]) // 向上滑動隱藏
slideToggle(speed, [callback]) // 滑動切換
fadeIn(speed, [callback]) // 淡入(只改變不透明度)
fadeOut(speed, [callback]) // 淡出
fadeTo(speed, opacity, [callback]) // 淡到指定不透明度
stop() // 停止當前動畫
queue() / queue(callback) / queue(queue) // 動畫序列操作
dequeue() // 執行並移除序列前端的動畫
animate(params, [duration], [easing], [callback]) // 自訂動畫
animate(params, options) // 自訂動畫的另一種參數形式
要點:slide 系列只調整高度,fade 系列只調整不透明度,兩者都不會改變元素的另一個維度。若同時有多個動畫排隊,記得在啟動新動畫前呼叫 .stop(),否則動畫會堆疊。
$("#myDiv") // 依 id 選取
$("div") // 依標籤名選取
$(".myClass") // 依 class 選取
$("*") // 選取全部元素
$("div,span,p.myClass") // 聯合多個選擇器
$("form input") // 後代選擇器:ancestor 的所有子孫節點
$("#main > *") // 子選擇器:parent 的直接子節點
$("label + input") // 相鄰選擇器:緊跟在 label 後的 input
$("#prev ~ div") // 同層選擇器:#prev 之後同父元素的所有 div
$("tr:first") // 第一個
$("tr:last") // 最後一個
$("input:not(:checked) + span") // 排除符合條件的元素
$("tr:even") // 偶數位置(從 0 起算)
$("tr:odd") // 奇數位置
$("td:eq(2)") // 指定位置
$("td:gt(4)") // 指定位置之後
$("td:lt(4)") // 指定位置之前
$(":header") // 所有標題元素
$("div:animated") // 正在執行動畫的元素
$("div:contains('John')") // 含指定文字的元素
$("td:empty") // 空元素(只含文字的不算空)
$("div:has(p)") // 至少含一個 p 的 div
$("td:parent") // 非空元素
$("div:hidden") // 隱藏元素,含表單隱藏域
$("div:visible") // 可見元素
$("div[id]") // 具有指定屬性
$("input[name='newsletter']") // 屬性值等於
$("input[name!='newsletter']") // 屬性值不等於
$("input[name^='news']") // 屬性值開頭為
$("input[name$='letter']") // 屬性值結尾為
$("input[name*='man']") // 屬性值包含
$("input[id][name$='man']") // 同時符合多個條件
$("ul li:nth-child(2)") // 父元素的第 2 個子元素
$("ul li:nth-child(odd)") // 奇數位子
$("ul li:nth-child(3n + 1)") // 支援公式
$("div span:first-child") // 第 1 個子元素
$("div span:last-child") // 最後 1 個子元素
$("div button:only-child") // 唯一子元素
$(":input") // 所有表單元素(input, textarea, select, button)
$(":text") $(":password") $(":radio") $(":checkbox")
$(":submit") $(":image") $(":reset") $(":button")
$(":file") $(":hidden")
$(":enabled") // 可操作的元素
$(":disabled") // 不可操作的元素
$(":checked") // 已勾選的
$("select option:selected") // 已選擇的選項
css(name) // 取得第一個元素的樣式屬性
css(properties) // 一次設定多個樣式
css(name, value) // 設定單一樣式
offset() // 相對於可視窗口的位置,回傳 {top, left}
width() / width(val) // 取得/設定寬度
height() / height(val) // 取得/設定高度
$("p").hover(function() {
$(this).css({ backgroundColor: "yellow", fontWeight: "bolder" });
}, function() {
var cssObj = { backgroundColor: "#ddd", fontWeight: "", color: "rgb(0,40,244)" };
$(this).css(cssObj);
});
var p = $("p:last");
var offset = p.offset();
p.html("left: " + offset.left + ", top: " + offset.top);
jQuery.browser.msie // 是否為 IE
jQuery.browser.version // 瀏覽器版本
jQuery.boxModel // 是否採用 W3C 盒模型
jQuery.isFunction(obj) // 是否為函式
jQuery.trim(str) // 清除字串兩端空格
jQuery.each(object, callback) // 通用迭代器
jQuery.extend(target, object1, [objectN]) // 物件合併,實作繼承的利器
jQuery.grep(array, callback, [invert]) // 篩選陣列
jQuery.makeArray(obj) // 類陣列轉真陣列
jQuery.map(array, callback) // 轉換陣列
jQuery.inArray(value, array) // 回傳索引,找不到回 -1
jQuery.unique(array) // 陣列去重
// 用法一:修改並回傳原物件
var settings = { validate: false, limit: 5, name: "foo" };
var options = { validate: true, name: "bar" };
jQuery.extend(settings, options); // settings 被改寫
// 用法二:以空物件為目標,原物件都不動
var empty = {};
var defaults = { validate: false, limit: 5, name: "foo" };
var options = { validate: true, name: "bar" };
var settings = $.extend(empty, defaults, options);
var arr = jQuery.makeArray(document.getElementsByTagName("div"));
arr.reverse(); // 現在可以用陣列方法了
$(arr).appendTo(document.body);
以上內容涵蓋了 jQuery 的精華,但必須補充幾點現實情況:
$.support 做特徵檢測,或直接不用。$(document).on('click', selector, fn)。on 與 off。.length。querySelectorAll、classList、fetch、addEventListener、Element.closest 等。這份速查的價值在於理解各方法的定位與取捨;實際動手時,建議對照你所使用 jQuery 版本的官方文件確認可用性。