這份筆記把 jQuery 最常用的方法依功能分類整理,適合當作開發時的速查表。
$("p").addClass(cssClass); // 加上樣式類
$("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(cls); // 有則移除、無則加入
$("input").val(); $("input").val(value); // 取得/設定表單值
$("元素").after(content); // 插入到後面
$("元素").append(content); // 插入到內部尾端
$("元素").appendTo(content); // 把自己接到 content 之後
$("元素").before(content); // 插入到前面(與 after 相反)
$("元素").clone(bool); // 複製元素
$("元素").empty(); // 清空內容
$("元素").insertAfter(content); // 把自己插到 content 之後
$("元素").insertBefore(content);
$("元素").prepend(content); // 插入到內部開頭
$("元素").prependTo(content);
$("元素").remove(); $("元素").remove("exp");
$("元素").wrap("html"); $("元素").wrap(element);
$(html).appendTo("body"); // 直接建立一段 HTML
$(elems); // 取得 DOM 元素
$(function () { ... }); // DOM 就緒後執行
$("div > p").css("border", "1px solid gray");
$("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)
each(callback); // 以每個匹配元素為上下文執行函式
中斷迴圈的寫法是 return false;:
$("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;
}
});
});
ready(fn):DOM 就緒時執行。注意若 body 上有 onload,此函式仍會執行,但時機在 onload 之前。
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() 則會同時取消瀏覽器的預設行為。
unbind([type], [data]):解除綁定,例如 $("p").unbind("click")。
load(url, [data], [callback]) // 載入遠端 HTML 到節點
$("#feeds").load("feeds.html");
$("#feeds").load("feeds.php", { limit: 25 }, function () {
alert("已載入最後 25 筆資料");
});
$.get(url, [data], [callback]); // GET 請求
$.getJSON(url, [data], cb); // GET 並解析 JSON
$.getScript(url, [callback]); // GET 並執行 JS 檔
$.post(url, [data], [callback], [type]);
$("#msg").ajaxComplete(function (req, settings) { ... });
$("#msg").ajaxError(function (req, settings) { ... });
$("#msg").ajaxSend(function (evt, req, settings) { ... });
$("#loading").ajaxStart(function () { $(this).show(); });
$("#loading").ajaxStop(function () { $(this).hide(); });
$("#msg").ajaxSuccess(function (evt, req, settings) { ... });
$.ajaxSetup({ url: "/xmlhttp/", global: false, type: "POST" });
serialize(); // 以「名稱=值」串接表單元素
serializeArray(); // 回傳 JSON 格式的陣列
show() / hide() / toggle() 切換可見性;slideDown() / slideUp() / slideToggle() 以高度變化做滑動效果;fadeIn() / fadeOut() / fadeTo() 以不透明度做淡入淡出。以上方法都可帶 speed 與 callback 參數。
另有 stop() 停止目前動畫、queue() 取得動畫序列、dequeue() 執行並移除序列前端,以及 animate(params, options) 自製動畫。
$("#myDiv") // id
$("div") // 標籤
$(".myClass") // class
$("*") // 全部
$("form input") // 後代
$("#main > *") // 子元素
$("label + input") // 相鄰
$("#prev ~ div") // 同層
$("tr:first") $("tr:last") $("tr:even") $("tr:odd")
$("td:eq(2)") $("td:gt(4)") $("td:lt(4)")
$(":header") $("div:animated")
$("div:contains('John')") $("td:empty")
$("div:has(p)") $("div:hidden") $("div:visible")
$("div[id]") $("input[name='newsletter']")
$("input[name^='news']") $("input[name$='letter']")
$("input[name*='man']")
$(":input") $(":text") $(":password") $(":radio") $(":checkbox")
$(":submit") $(":reset") $(":button") $(":file") $(":hidden")
$(":enabled") $(":disabled") $(":checked")
$("select option:selected")
jQuery.browser.msie
jQuery.browser.version
jQuery.boxModel
jQuery.isFunction(obj)
jQuery.trim(str)
jQuery.each(object, callback)
jQuery.extend(target, obj1, [objN])
jQuery.grep(array, callback, [invert])
jQuery.makeArray(obj)
jQuery.map(array, callback)
jQuery.inArray(value, array)
jQuery.unique(array)
把這份清單存進書籤,開發時遇到不確定的方法名,查一下就能節省不少時間。