DIV CSS 佈局教程網

jQuery 常用方法完整參考:操作、事件、Ajax、效果、選擇器
編輯: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>");                       // 設定元素的 HTML 內容
$("元素名稱").removeAttr("屬性名稱");                            // 刪除指定屬性及其值
$("元素名稱").removeClass("class");                            // 刪除指定樣式類
$("元素名稱").text();                                          // 取得元素的純文字內容
$("元素名稱").text(value);                                     // 設定元素的文字內容
$("元素名稱").toggleClass(class);                              // 有則移除、無則加上
$("input元素名稱").val();                                       // 取得 input 的值
$("input元素名稱").val(value);                                  // 設定 input 的值

二、節點操作(Manipulation)

$("元素名稱").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 包圍該元素

三、DOM 走訪(Core 與 Traversing)

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

四、事件(jQuery Event)

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 事件。

  • blur():元素失去焦點。支援 a、input、textarea、button、select、label、map、area。
  • change():使用者改變欄位內容。支援 input、textarea、select。
  • click():滑鼠點擊物件。幾乎所有元素。
  • dblclick():滑鼠雙擊。幾乎所有元素。
  • error():載入文件或圖片時發生錯誤。支援 window、img。
  • focus():元素獲得焦點。支援 a、input、textarea、button、select、label、map、area。
  • keydown() / keypress() / keyup():按鍵被按下/按住/放開。幾乎所有元素。
  • load(fn):頁面或圖片完成載入。支援 window、img。
  • mousedown(fn) / mouseup(fn):滑鼠按鍵被按下/放開。幾乎所有元素。
  • mousemove(fn):滑鼠被移動。mouseover(fn):滑鼠移到元素上。mouseout(fn):滑鼠移開元素。
  • resize(fn):視窗或框架被調整尺寸。支援 window、iframe、frame。
  • scroll(fn):捲動文件的可視部分。支援 window。
  • select():文字被選定。支援 document、input、textarea。
  • submit():提交按鈕被點擊。支援 form。
  • unload(fn):使用者離開頁面。支援 window。

五、Ajax 方法

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 請求頁面。

Ajax 事件

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

六、效果(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):回傳與表達式符合的元素集合,可用逗號分隔多個 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");

八、選擇器(Selectors)

基本選擇器

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

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) 取得/設定第一個符合元素的高度。

十、工具方法(Utilities)

  • 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)。

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