這份筆記把常用 jQuery 方法依分類整理成速查表,適合當桌面參考。
$("p").addClass(css中定義的樣式類型); // 加上樣式
$("img").attr({ src: "test.jpg", alt: "test Image" }); // 以 map 一次設定多組屬性
$("img").attr("src", "test.jpg"); // 設定單一屬性
$("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 值
$("元素").after(content); // 於符合元素之後插入內容
$("元素").append(content); // 作為子節點附加到最後
$("元素").appendTo(content); // 把元素附加到 content 之後
$("元素").before(content); // 與 after 相反
$("元素").clone(布爾值); // 複製元素,參數為真時連事件一起複製
$("元素").empty(); // 清空內容
$("元素").insertAfter(content); // 插入到 content 之後
$("元素").insertBefore(content); // 插入到 content 之前
$("元素").prepend(content); // 作為子節點放到最前面
$("元素").prependTo(content); // 放到 content 的最前面
$("元素").remove(); // 刪除符合元素
$("元素").remove("exp"); // 刪除符合 exp 的元素
$("元素").wrap("html"); // 用 html 包圍元素
$("元素").wrap(element); // 用指定元素包圍
add(expr) / add(html) / add(elements)
children(expr)
contains(str)
end()
filter(expression) / filter(filter)
find(expr)
is(expr)
next(expr)
not(el) / not(expr) / not(elems)
parent(expr)
parents(expr)
prev(expr)
siblings(expr)
$(html).appendTo("body"); // 等同在 body 寫入一段 HTML
$(elems); // 取得 DOM 元素並包裝
$(function () { ... }); // 等同 ready
$("div > p").css("border", "1px solid gray");
$("input:radio", document.forms[0]); // 在頁面第一個表單中找單選鈕
// 擴充 jQuery 物件
jQuery.extend({
min: function (a, b) { return a < b ? a : b; },
max: function (a, b) { return a > b ? a : b; }
});
// jQuery(expression, [context]) —— 預設搜尋當前文件的 DOM
each(callback) 以每個符合元素為上下文執行函式:
$("span").click(function () {
$("li").each(function () {
$(this).toggleClass("example");
});
});
$("button").click(function () {
$("div").each(function (index, domEle) {
// domEle == this
$(domEle).css("backgroundColor", "yellow");
if ($(this).is("#stop")) {
$("span").text("Stopped at div index #" + index);
return false; // 回傳 false 可中止迴圈
}
});
});
ready(fn); // 文件就緒;注意 body 若有 onload 則不會執行
bind(type, [data], fn); // 綁定一或多個事件處理器
one(type, [data], fn); // 每個元素只執行一次的處理器
trigger(type, [data]); // 觸發事件
triggerHandler(type, [data]); // 觸發並取消瀏覽器預設行為
unbind([type], [data]); // 解除綁定
$("p").unbind(); // 移除所有段落的所有事件
$("p").unbind("click"); // 移除所有段落的 click
hover(over, out); // 移入執行 over,移出執行 out
$("p").hover(
function () { $(this).addClass("over"); },
function () { $(this).addClass("out"); }
);
toggle(fn, fn); // 第一次點擊跑第一個,第二次跑第二個
$("p").toggle(
function () { $(this).addClass("selected"); },
function () { $(this).removeClass("selected"); }
);
可綁定的常見事件:blur、focus、load、resize、scroll、unload、click、dblclick、mousedown、mouseup、mousemove、mouseover、mouseout、mouseenter、mouseleave、change、select、submit、keydown、keypress、keyup、error。
各事件對應的支援元素(摘要):
blur() 失去焦點:a、input、textarea、button、select、label、map、areachange() 內容變更:input、textarea、selectclick() / dblclick():幾乎所有元素error() 載入錯誤:window、imgload(fn) 載入完成:window、imgresize(fn) 尺寸調整:window、iframe、framescroll(fn) 捲動:windowselect() 文字選取:document、input、textareasubmit() 表單提交:formunload(fn) 離開頁面:window補充:不帶參數的函式,其參數為可選的 fn;jQuery 不支援 form 元素的 reset 事件。
load(url, [data], [callback]); // 載入遠端 HTML 到節點
$("#feeds").load("feeds.html");
$("#feeds").load("feeds.php", { limit: 25 }, function () {
alert("The last 25 entries in the feed have been loaded");
});
jQuery.get(url, [data], [callback]);
$.get("test.cgi", { name: "John", time: "2pm" }, function (data) {
alert("Data Loaded: " + data);
});
jQuery.getJSON(url, [data], [callback]);
$.getJSON("test.js", { name: "John", time: "2pm" }, function (json) {
alert("JSON Data: " + json.users[3].name);
});
jQuery.getScript(url, [callback]);
$.getScript("test.js", function () { alert("Script loaded and executed."); });
jQuery.post(url, [data], [callback], [type]);
Ajax 全域事件:
$("#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").ajaxStart(function () { $(this).show(); }); // 顯示 loading
$("#loading").ajaxStop (function () { $(this).hide(); }); // 隱藏 loading
$("#msg").ajaxSuccess(function (evt, request, settings) {
$(this).append("<li>Successful Request!</li>");
});
全域預設值設定:
$.ajaxSetup({
url: "/xmlhttp/",
global: false,
type: "POST"
});
$.ajax({ data: myData });
表單序列化:
function showValues() {
var str = $("form").serialize();
$("#results").text(str);
}
$(":checkbox, :radio").click(showValues);
$("select").change(showValues);
showValues();
// serializeArray() 回傳 JSON 結構
function showValues2() {
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);
eq(index); // 取得指定位置的單一元素,index 從 0 起
filter(expr); // 保留符合運算式的元素,可用逗號做多條件
filter(fn); // 以函式作為篩選條件
is(expr); // 集合中至少一個符合即回傳 true
map(callback); // 逐一轉換並收集結果
not(expr); // 排除符合運算式的元素
slice(start, [end]);
add(expr);
children([expr]);
contents(); // 取得所有子孫節點;若為 iframe 則取其文件
find(expr);
next([expr]);
nextAll([expr]);
parent([expr]);
parents([expr]);
prev([expr]);
prevAll([expr]);
siblings([expr]);
andSelf(); // 把前一次集合併回目前集合
$("div").find("p").andSelf().addClass("border");
$("div").find("p").addClass("background");
end(); // 回到上一次操作
$("p").find("span").end().css("border", "2px red solid");
基本:
$("#myDiv") // id
$("div") // 標籤
$(".myClass") // class
$("*") // 全部
$("div,span,p.myClass")// 聯集
層疊:
$("form input") // 後代
$("#main > *") // 子元素
$("label + input") // 相鄰
$("#prev ~ div") // 同輩
基本篩選:
$("tr:first") $("tr:last")
$("tr:even") $("tr:odd") // 索引從 0 起
$("td:eq(2)") $("td:gt(4)") $("td:lt(4)")
$(":header") // 所有標題
$("div:animated") // 正在跑動畫的元素
$("input:not(:checked) + span")
內容篩選:
$("div:contains('John')") // 含指定文字
$("td:empty") // 空元素
$("div:has(p)") // 含指定後代
$("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)")
$("ul li:nth-child(odd)")
$("ul li:nth-child(3n + 1)")
$("div span:first-child")
$("div span:last-child")
$("div button:only-child")
表單:
$(":input") $(":text") $(":password") $(":radio") $(":checkbox")
$(":submit") $(":image") $(":reset") $(":button") $(":file") $(":hidden")
$(":enabled") $(":disabled") $(":checked")
$("select option:selected")
css(name); // 讀取樣式
css(properties); // 以 name/value 物件設定
css(name, value);
$("p").hover(
function () { $(this).css({ backgroundColor: "yellow", fontWeight: "bolder" }); },
function () {
$(this).css({ backgroundColor: "#ddd", fontWeight: "", color: "#0028f4" });
}
);
offset(); // 取得相對可視窗口的位置,回傳 { top, left },僅限可見元素
var offset = $("p:last").offset();
$("p:last").html("left: " + offset.left + ", top: " + offset.top);
width(); width(val);
height(); height(val);
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) // 去除重複
extend 的兩種典型用法:
// 合併 settings 與 options,回傳被修改後的 settings
var settings = { validate: false, limit: 5, name: "foo" };
var options = { validate: true, name: "bar" };
jQuery.extend(settings, options);
// 以 empty 為目標,defaults 不被修改
var empty = {};
var defaults = { validate: false, limit: 5, name: "foo" };
var settings2 = $.extend(empty, defaults, options);
var arr = jQuery.makeArray(document.getElementsByTagName("div"));
arr.reverse(); // 對 DOM 集合使用陣列方法
$(arr).appendTo(document.body);
$.grep([0, 1, 2], function (n, i) { return n > 0; });
要注意的是,jQuery.browser 在 jQuery 1.9 之後已移除,新專案請改用 $.support 或直接做特性偵測。