$("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>"); // 設定元素的 HTML 內容
$("元素名稱").removeAttr("屬性名稱"); // 刪除指定屬性及其值
$("元素名稱").removeClass("class"); // 刪除指定樣式類
$("元素名稱").text(); // 取得元素的純文字內容
$("元素名稱").text(value); // 設定元素的文字內容
$("元素名稱").toggleClass(class); // 有則移除、無則加上
$("input元素名稱").val(); // 取得 input 的值
$("input元素名稱").val(value); // 設定 input 的值
$("元素名稱").after(content); // 在符合元素後面插入內容
$("元素名稱").append(content); // 把 content 作為內容接在元素後面
$("元素名稱").appendTo(content); // 把元素接在 content 後面
$("元素名稱").before(content); // 與 after 相反
$("元素名稱").clone(布林運算式); // 克隆元素(無參數時視為 true)
$("元素名稱").empty(); // 清空元素內容
$("元素名稱").insertAfter(content); // 把元素插入到 content 之後
$("元素名稱").insertBefore(content); // 把元素插入到 content 之前
$("元素").prepend(content); // 把 content 放到元素的最前面
$("元素").prependTo(content); // 把元素放到 content 的最前面
$("元素").remove(); // 刪除所有符合的元素
$("元素").remove("exp"); // 刪除所有含有 exp 的元素
$("元素").wrap("html"); // 用 html 包圍該元素
$("元素").wrap(element); // 用 element 包圍該元素
$(html).appendTo("body"); // 等同在 body 中寫入一段 html
$(elems); // 取得 DOM 上的元素
$(function(){ ... }); // 執行一個函式(DOM 就緒後)
$("div > p").css("border", "1px solid gray"); // 找出 div 的所有子節點 p 並加樣式
$("input:radio", document.forms[0]); // 在第一個表單中找出所有單選鈕
$.extend(prop) 用來擴充 jQuery 物件本身,例如加上自用的工具函式:
jQuery.extend({
min: function(a, b) { return a < b ? a : b; },
max: function(a, b) { return a > b ? a : b; }
});
jQuery(expression, [context]) 即 $(expression, [context]),預設查詢目前 HTML 文件中的 DOM 元素。
each(callback) 以每個符合的元素作為上下文來執行函式:
// 範例 1
$("span").click(function(){
$("li").each(function(){
$(this).toggleClass("example");
});
});
// 範例 2
$("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 可中止迭代
}
});
});
走訪方法一覽:add(expr/html/elements)、children(expr)、contains(str)、end()、filter(expression/filter)、find(expr)、is(expr)、next(expr)、not(el/expr/elems)、parent(expr)、parents(expr)、prev(expr)、siblings(expr)。
ready(fn) 等同 $(document).ready()。注意 body 中不能有 onload 事件,否則該函式不會執行。每個頁面可以有多個函式被載入執行,依 fn 的順序執行。
bind(type, [data], fn) 為每個符合元素的特定事件綁定一或多個事件處理器。可能的事件有:blur、focus、load、resize、scroll、unload、click、dblclick、mousedown、mouseup、mousemove、mouseover、mouseout、mouseenter、mouseleave、change、select、submit、keydown、keypress、keyup、error。
one(type, [data], fn) 規則與 bind() 相同,但在每個物件上該事件處理函式只會執行一次。
trigger(type, [data]) 在每個符合元素上觸發某類事件。triggerHandler(type, [data]) 會觸發特定事件並取消瀏覽器對該事件的預設行為。unbind([type], [data]) 反向解除綁定。
$("p").unbind(); // 移除所有段落上的所有綁定事件
$("p").unbind("click"); // 移除所有段落上的 click 事件
hover(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");
});
註:不帶參數的函式,其參數 fn 為可選。jQuery 不支援 form 元素的 reset 事件。
load(url, [data], [callback]) 把遠端 HTML 內容載入某個 DOM 節點。
$("#feeds").load("feeds.html"); // 把 feeds.html 載入 id 為 feeds 的 div
$("#feeds").load("feeds.php", {limit: 25}, function(){
alert("The last 25 entries in the feed have been loaded");
});
jQuery.get(url, [data], [callback]) 以 GET 請求頁面。
$.get("test.cgi", { name: "John", time: "2pm" }, function(data){
alert("Data Loaded: " + data);
});
jQuery.getJSON(url, [data], [callback]) 以 GET 請求 JSON 資料。
$.getJSON("test.js", { name: "John", time: "2pm" }, function(json){
alert("JSON Data: " + json.users[3].name);
});
jQuery.getScript(url, [callback]) 以 GET 請求並執行 javascript 檔。
$.getScript("test.js", function(){
alert("Script loaded and executed.");
});
jQuery.post(url, [data], [callback], [type]) 以 POST 請求頁面。
// ajaxComplete:一個 AJAX 請求結束後執行
$("#msg").ajaxComplete(function(request, settings){
$(this).append("<li>Request Complete.</li>");
});
// ajaxError:一個 AJAX 請求失敗後執行
$("#msg").ajaxError(function(request, settings){
$(this).append("<li>Error requesting page " + settings.url + "</li>");
});
// ajaxSend:在一個 AJAX 請求發送時執行
$("#msg").ajaxSend(function(evt, request, settings){
$(this).append("<li>Starting request at " + settings.url + "</li>");
});
// ajaxStart:請求開始但尚未激活時執行——顯示 loading 訊息
$("#loading").ajaxStart(function(){
$(this).show();
});
// ajaxStop:所有 AJAX 都停止時執行——隱藏 loading 訊息
$("#loading").ajaxStop(function(){
$(this).hide();
});
// ajaxSuccess:請求成功完成後執行
$("#msg").ajaxSuccess(function(evt, request, settings){
$(this).append("<li>Successful Request!</li>");
});
jQuery.ajaxSetup(options) 為所有 Ajax 請求做全域設定:
$.ajaxSetup({
url: "/xmlhttp/",
global: false,
type: "POST"
});
$.ajax({ data: myData });
serialize() 以名稱和值的方式連接一組 input 元素,能正確處理表單元素序列化:
function showValues() {
var str = $("form").serialize();
$("#results").text(str);
}
$(":checkbox, :radio").click(showValues);
$("select").change(showValues);
showValues();
serializeArray() 同樣序列化表單元素,但回傳 JSON 資料格式:
function showValues() {
var fields = $(":input").serializeArray();
alert(fields);
$("#results").empty();
jQuery.each(fields, function(i, field){
$("#results").append(field.value + " ");
});
}
$(":checkbox, :radio").click(showValues);
$("select").change(showValues);
showValues();
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):回傳與表達式符合的元素集合,可用逗號分隔多個 expr 做多條件篩選;filter(fn) 則用函式作為篩選條件。is(expr):用表達式檢查目前集合,只要有一個元素符合就回傳 true。map(callback):用 callback 轉換集合中每個元素的值,加到一個 jQuery 陣列中。not(expr):從符合集合中刪除與表達式符合的元素。slice(start, [end]):取出集合的子集,用法同原生陣列的 slice。add(expr):把與表達式符合的元素加到 jQuery 物件中。children([expr]):取得每個符合元素的所有子元素集合,可用過濾器篩選(只含元素節點,不含文字節點)。contents():取得所有子孫節點集合;若元素為 iframe 則取得其中的文件元素。find(expr):搜尋所有與表達式符合的後代元素。next([expr]) / nextAll([expr]):取得緊鄰的後面同輩元素/所有後面同輩元素。parent([expr]) / parents([expr]):取得父元素/所有祖先元素(不含根元素)。prev([expr]) / prevAll([expr]):取得緊鄰的前面同輩元素/所有前面同輩元素。siblings([expr]):取得所有同輩元素。andSelf():把前一個符合的元素集合加到目前集合中。end():結束目前操作,回到前一個操作。// 取得所有 div 中的 p 元素並加上 p 與 div 兩種樣式
$("div").find("p").andSelf().addClass("border");
// 只為 div 中的 p 加上樣式
$("div").find("p").addClass("background");
// 找到 p 中的 span 集合,再返回 p 集合並加上 CSS
$("p").find("span").end().css("border", "2px red solid");
$("#myDiv") // 符合具有該 id 的唯一元素
$("div") // 符合指定名稱的所有元素
$(".myClass") // 符合具有該 class 的所有元素
$("*") // 符合所有元素
$("div,span,p.myClass") // 聯合所有符合的選擇器
$("form input") // 後代選擇器:ancestor 的所有子孫節點
$("#main > *") // 子選擇器:parent 的所有直接子節點
$("label + input") // 臨選擇器:prev 的下一個臨節點
$("#prev ~ div") // 同胞選擇器:prev 的所有同胞節點
$("tr:first") // 第一個符合的元素
$("tr:last") // 最後一個符合的元素
$("input:not(:checked) + span") // 過濾掉符合 selector 的元素
$("tr:even") // 集合中偶數位置的元素(從 0 開始)
$("tr:odd") // 集合中奇數位置的元素(從 0 開始)
$("td:eq(2)") // 集合中指定位置的元素(從 0 開始)
$("td:gt(4)") // 指定位置之後的所有元素
$("td:lt(4)") // 指定位置之前的所有元素
$(":header") // 所有標題元素
$("div:animated") // 所有正在執行動畫的元素
$("div:contains('John')") // 含有指定文字的所有元素
$("td:empty") // 所有空元素(只含文字的不算空)
$("div:has(p)") // 至少含有一個符合 selector 的後代
$("td:parent") // 所有不為空的元素(含文字的也算)
$("div:hidden") // 所有隱藏元素,也包含表單的隱藏域
$("div:visible") // 所有可見元素
$("div[id]") // 所有具有該屬性的元素
$("input[name='newsletter']") // 具有指定屬性值的元素
$("input[name!='newsletter']") // 不具有指定屬性值的元素
$("input[name^='news']") // 屬性值以 value 開頭
$("input[name$='letter']") // 屬性值以 value 結尾
$("input[name*='man']") // 屬性值含有 value 字元
$("input[id][name$='man']") // 同時符合多個選擇器
$("ul li:nth-child(2)") // 父元素中的第 n 個子元素
$("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") // 父元素中唯一的 1 個子元素
$(":input") // 所有表單輸入元素,含各型別 input、textarea、select、button
$(":text") // 所有 text 類型的 input
$(":password") // 所有 password 類型的 input
$(":radio") // 所有 radio 類型的 input
$(":checkbox") // 所有 checkbox 類型的 input
$(":submit") // 所有 submit 類型的 input
$(":image") // 所有 image 類型的 input
$(":reset") // 所有 reset 類型的 input
$(":button") // 所有 button 類型的 input
$(":file") // 所有 file 類型的 input
$(":hidden") // 所有 hidden 類型的 input 或表單隱藏域
$(":enabled") // 所有可操作的表單元素
$(":disabled") // 所有不可操作的表單元素
$(":checked") // 所有已勾選的元素
$("select option:selected") // 所有已選擇的選項
css(name) // 存取第一個符合元素的樣式屬性
css(properties) // 把「名/值對」物件設為所有符合元素的樣式
css(name, value) // 為所有符合元素設定單一樣式屬性的值
$("p").hover(function () {
$(this).css({ backgroundColor:"yellow", fontWeight:"bolder" });
}, function () {
var cssObj = {
backgroundColor: "#ddd",
fontWeight: "",
color: "rgb(0,40,244)"
}
$(this).css(cssObj);
});
offset() 取得第一個符合元素相對於目前可視窗口的位置,回傳物件有 top 與 left 兩個整數屬性。此函式只能用於可見元素。
var p = $("p:last");
var offset = p.offset();
p.html("left: " + offset.left + ", top: " + offset.top);
width() / width(val) 取得/設定第一個符合元素的寬度。height() / height(val) 取得/設定第一個符合元素的高度。
jQuery.browser.msie:是否為 IE。jQuery.browser.version:讀取瀏覽器版本資訊。jQuery.boxModel:偵測瀏覽器是否以 W3C CSS 盒模型呈現目前頁面。jQuery.isFunction(obj):偵測參數是否為 function。jQuery.trim(str):清除字串兩端的空格,使用正則表達式實作。jQuery.each(object, callback):通用迭代器,可無縫迭代物件與陣列。jQuery.extend(target, object1, [objectN]):擴充物件並回傳,是強大的繼承實作工具。這種繼承採傳值方式,而非 JavaScript 的原型鏈方式。jQuery.grep(array, callback, [invert]):透過篩選函式去除陣列中的項目。jQuery.makeArray(obj):把類陣列物件轉為真正的陣列。jQuery.map(array, callback):用某方法修改陣列中的項目並回傳新陣列。jQuery.inArray(value, array):回傳 value 在陣列中的位置,找不到則回 -1。jQuery.unique(array):刪除陣列中重複的元素並回傳整理後的陣列。function stub() { }
var objs = [
function () {},
{ x:15, y:20 },
null,
stub,
"function"
];
jQuery.each(objs, function (i) {
var isFunc = jQuery.isFunction(objs[i]);
$("span:eq( " + i + ")").text(isFunc);
});
合併 settings 與 options,回傳修改後的 settings:
var settings = { validate: false, limit: 5, name: "foo" };
var options = { validate: true, name: "bar" };
jQuery.extend(settings, options);
// settings == { validate: true, limit: 5, name: "bar" }
合併時 defaults 並未被修改,options 的值覆蓋 defaults 後傳給 empty:
var empty = {}
var defaults = { validate: false, limit: 5, name: "foo" };
var options = { validate: true, name: "bar" };
var settings = $.extend(empty, defaults, options);
// 用篩選函式去除陣列項目
$.grep([0,1,2], function(n,i){
return n > 0;
});
// 把選取的 div 集合轉為陣列,才能用陣列方法
var arr = jQuery.makeArray(document.getElementsByTagName("div"));
arr.reverse();
$(arr).appendTo(document.body);
這份清單涵蓋了 jQuery 日常開發絕大多數會用到的 API。實際上手時不必硬背,先熟悉選擇器、attr/css/text/val 這組基本操作、ready 與事件綁定、以及 $.ajax 這四大塊,其餘方法在需要時回頭查官方文件即可。
另外提醒:jQuery.browser 這類瀏覽器偵測 API 在 jQuery 1.9 之後已被移除,判斷功能時建議改用特性偵測(例如 !!document.createElement('canvas').getContext)。