DIV CSS 佈局教程網

jQuery 常用方法與選擇器大全:DOM、事件、Ajax、效果分類速查
編輯:JavaScript綜合知識     

這是一篇整理性質的速查筆記,把 jQuery 最常使用的方法依功能分類條列,附上簡短說明與範例,方便開發時快速查找。

一、DOM 屬性操作(Attribute)

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

二、DOM 操作(Manipulation)

$("元素").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) 會連綁定的事件一起複製,這在需要複製互動元件時很實用,但也要注意它會複製事件而非引用同一個處理器。

三、DOM 遍歷(Traversing)

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)  // 取得所有兄弟元素

add 範例

$(document).ready(function() {
    $("div").css("border", "2px solid red")
            .add("p")                        // 把 p 元素也加入集合
            .css("background", "yellow");    // div 與 p 都會套用黃底
});

end 範例

$("#div1").find("p").hide().end().hide()

第一個 hide() 作用於 p 標籤,end() 結束對 p 的參照並回到 #div1,因此第二個 hide() 作用於 #div1。若不加 end(),兩個 hide 都會作用在 p 上。

filter 與 find 的差別

這兩個方法很容易搞混,用一個例子說明:

<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 的那些。一個對子集操作,一個對自身集合篩選。

四、核心(Core)

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

each 範例

// 範例一
$("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 可跳出迴圈
        }
    });
});

五、事件(Event)

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)           // 第一次點擊執行第一個函式,第二次執行第二個

bind 與 trigger 範例

$('#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"]);

unbind 範例

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

常用元素事件對照

  • focus / blur:元素獲得/失去焦點(a, input, textarea, button, select 等)
  • change:使用者改變表單內容,元素失焦時或值改變後觸發(input, textarea, select)
  • click / dblclick:單擊/雙擊(幾乎所有元素)
  • error:載入文件或圖片時發生錯誤(window, img)
  • keydown / keypress / keyup:按鍵按下/按下並按住/放開
  • load:頁面或圖片載入完成(window, img)
  • resize:視窗或框架尺寸改變(window, iframe, frame)
  • scroll:捲動文件可視區域(window)
  • select:文字被選取(document, input, textarea)
  • submit:表單提交(form)
  • unload:使用者離開頁面(window)

補充:jQuery 不支援 form 元素的 reset 事件。另外 focus/blur 那組範例展示了常見的搜尋框提示文字做法:

$("#in").focus(function() {
    if ($("#in").val() == '關鍵字') { $("#in").val(""); }
}).blur(function() {
    if ($("#in").val() == '') {
        $("#in").val("關鍵字").css("color", "#ccc");
    }
});

六、Ajax

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

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

七、效果(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)                 // 自訂動畫的另一種參數形式

要點:slide 系列只調整高度,fade 系列只調整不透明度,兩者都不會改變元素的另一個維度。若同時有多個動畫排隊,記得在啟動新動畫前呼叫 .stop(),否則動畫會堆疊。

八、選擇器(Selectors)

基礎選擇器

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

css(name)                    // 取得第一個元素的樣式屬性
css(properties)              // 一次設定多個樣式
css(name, value)             // 設定單一樣式
offset()                     // 相對於可視窗口的位置,回傳 {top, left}
width() / width(val)         // 取得/設定寬度
height() / height(val)       // 取得/設定高度

hover 切換樣式範例

$("p").hover(function() {
    $(this).css({ backgroundColor: "yellow", fontWeight: "bolder" });
}, function() {
    var cssObj = { backgroundColor: "#ddd", fontWeight: "", color: "rgb(0,40,244)" };
    $(this).css(cssObj);
});

offset 範例

var p = $("p:last");
var offset = p.offset();
p.html("left: " + offset.left + ", top: " + offset.top);

十、工具函式(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 的兩種用法

// 用法一:修改並回傳原物件
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);

makeArray 範例

var arr = jQuery.makeArray(document.getElementsByTagName("div"));
arr.reverse();                       // 現在可以用陣列方法了
$(arr).appendTo(document.body);

結語與現代化提醒

以上內容涵蓋了 jQuery 的精華,但必須補充幾點現實情況:

  • jQuery.browser 已於 1.9 移除,改用 $.support 做特徵檢測,或直接不用。
  • live 已於 1.9 移除,delegate 在 3.0 標記棄用,統一改用 $(document).on('click', selector, fn)。
  • bind / unbind / delegate / undelegate 都已棄用,改用 on 與 off。
  • .size() 已移除,改用 .length。
  • .toggle(fn, fn) 這種事件切換用法已移除,需自行用旗標實作。
  • 新專案若不需要兼容 IE,許多原生 API 已可直接取代 jQuery:querySelectorAll、classList、fetch、addEventListener、Element.closest 等。

這份速查的價值在於理解各方法的定位與取捨;實際動手時,建議對照你所使用 jQuery 版本的官方文件確認可用性。

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