DIV CSS 佈局教程網

jQuery API 速查大全:DOM、事件、Ajax、特效、選擇器一次收錄
編輯:JQuery特效代碼     

這份筆記把常用 jQuery 方法依分類整理成速查表,適合當桌面參考。

一、DOM 操作

Attribute 屬性

$("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 值

Manipulation 節點操作

$("元素").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);           // 用指定元素包圍

Traversing 遍歷

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)

Core 核心

$(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 可中止迴圈
        }
    });
});

二、事件 Event

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、area
  • change() 內容變更:input、textarea、select
  • click() / dblclick():幾乎所有元素
  • error() 載入錯誤:window、img
  • load(fn) 載入完成:window、img
  • resize(fn) 尺寸調整:window、iframe、frame
  • scroll(fn) 捲動:window
  • select() 文字選取:document、input、textarea
  • submit() 表單提交:form
  • unload(fn) 離開頁面:window

補充:不帶參數的函式,其參數為可選的 fn;jQuery 不支援 form 元素的 reset 事件。

三、Ajax

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 + " ");
    });
}

四、特效 Effects

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);

五、Traversing 遍歷

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");

六、Selectors 選擇器

基本:

$("#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

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);

八、Utilities 工具

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 或直接做特性偵測。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved