要開始使用 jQuery,最常見的有兩種方式。第一種是把 jQuery 檔案下載到本地,透過 script 標籤直接引用:
<head><script src="jquery.js"></script></head>
第二種是使用 CDN,直接從 Google 的資源伺服器載入,省去自行託管的麻煩:
<head><script src="https://ajax.googleapis.com/ajax/libs/jquery/1.8.0/jquery.min.js"></script></head>
jQuery 的核心語法可以濃縮成一個公式:$(selector).action()。其中美元符號 $ 就是 jQuery 的別名;selector(選擇器)負責「查詢」並「找到」HTML 元素;而 action() 則是對這些元素執行的具體操作。
下面是一個典型範例,示範如何在文件就緒後為元素綁定點擊事件:
$(document).ready(function(){
// 確保文件完全載入後才執行 jQuery 程式碼
$(button).click(function(){
$(this).hide(); // 隱藏當前被點擊的元素
$("p").hide(); // 隱藏所有段落
$(".test").hide(); // 隱藏所有 class 為 test 的元素
$("#test").hide(); // 隱藏 id 為 test 的元素
});
});
jQuery 沿用 CSS 選擇器來挑選元素:
$("p") 選取所有 <p> 元素。$("p.intro") 選取所有 class 為 intro 的 <p> 元素。$("p#demo") 選取 id 為 demo 的 <p> 元素。借助屬性表達式,可以精準鎖定帶有特定屬性的元素:
$("[href]") 選取所有帶有 href 屬性的元素。$("[href='#']") 選取 href 值等於「#」的元素。$("[href!='#']") 選取 href 值不等於「#」的元素。$("[href$='.jpg']") 選取 href 值以「.jpg」結尾的元素。也可以直接用 jQuery 設定樣式:
$("p").css("background-color","red");
jQuery 提供了一整套事件方法,用來綁定或觸發各種互動行為:
$(document).ready(function):將函式綁定到文件就緒事件(文件載入完成時觸發)。$(selector).click(function):觸發或綁定點擊事件。$(selector).dblclick(function):觸發或綁定雙擊事件。$(selector).focus(function):觸發或綁定取得焦點事件。$(selector).mouseover(function):觸發或綁定滑鼠懸停事件。$("selector").hide(speed,callback); // speed 可為 slow、fast 或毫秒數
$("selector").show(speed,callback); // callback 為顯示或隱藏後執行的函式
$(selector).toggle(speed,callback); // 在顯示與隱藏之間切換
$(selector).fadeIn(speed,callback); // 淡入已隱藏的元素 $(selector).fadeOut(speed,callback); // 淡出目前顯示的元素 $(selector).fadeToggle(speed,callback);// 淡入淡出切換 $(selector).fadeTo(speed,opacity,callback); // 漸變到指定的不透明度(0 到 1 之間)
$(selector).slideDown(speed,callback); // 向下滑動展開元素 $(selector).slideUp(speed,callback); // 向上滑動收起元素 $(selector).slideToggle(speed,callback); // 在上下滑動之間切換
animate() 方法能自訂動畫,其中 params 參數定義要做成動畫的 CSS 屬性:
$(selector).animate({params},speed,callback);
特別提醒:若要對元素位置做動畫,必須先把該元素的 CSS position 屬性設為 relative、fixed 或 absolute。
$("button").click(function(){
$("div").animate({
left:'250px', // 移動到左側 250px 處
opacity:'0.5', // 調整透明度
height:'+=150px', // 在原本基礎上增加 150px
width:'toggle' // 預設值,可為 hide / show / toggle
});
});
animate 也支援佇列寫法,動畫會依序執行:
var div = $("div");
div.animate({CSS屬性},speed,callback);
div.animate({CSS屬性},speed,callback);
$(selector).stop(); // 停止當前動畫,接著執行下一個 $(selector).stop(true); // 停止所有排队的動畫 $(selector).stop(true,true);// 停止動畫並直接完成當前動畫
callback 讓你可以在動畫或效果完成後再執行額外邏輯:
$("p").hide(1000,function(){ alert("test"); });
jQuery 支援把多個方法串在一起呼叫,讓程式碼更精簡。注意每個方法之間不要加分號:
$(selector).css("color","red").slideUp(100).slideDown(100);
text():設定或回傳所選元素的純文字內容。html():設定或回傳所選元素的內容(包含 HTML 標記)。val():設定或回傳表單欄位的值。attr():獲取或設定元素屬性值。alert("html:" + $(selector).html());
回呼函式讓你能根據每個元素的現況動態決定設定值:
$("#btn1").click(function(){
$("#test1").text(function(i,origText){
return "Old text: " + origText + " New text: Hello world!(index: " + i + ")";
});
});
$("#btn2").click(function(){
$("#test2").html(function(i,origText){
return "Old html: " + origText + " New html: Hello <b>world!</b> (index: " + i + ")";
});
});
$("button").click(function(){
$("#w3s").attr("href", function(i,origValue){
return origValue + "/jquery";
});
});
// 一次設定多個屬性
$("button").click(function(){
$("#w3s").attr({
"href" : "https://hovertree.com/menu/jquery",
"title" : "HoverTree jQuery Tutorial"
});
});
append():在被選元素的結尾插入內容。prepend():在被選元素的開頭插入內容。after():在被選元素之後插入內容。before():在被選元素之前插入內容。function afterText(){
var txt1 = "<b>I </b>"; // 以 HTML 字串建立新元素
var txt2 = $("<i></i>").text("love "); // 透過 jQuery 建立新元素
var txt3 = document.createElement("big"); // 透過 DOM 建立新元素
txt3.innerHTML = "jQuery!";
$("img").after(txt1,txt2,txt3); // 在 img 之後插入新元素
}
remove():刪除被選中的元素(可帶選擇器過濾)。empty():刪除被選元素的子元素。$("p").remove(".cl"); // 刪除 p 中 class 為 cl 的元素
addClass():為元素新增一個或多個類(多個類以空格分隔)。removeClass():從元素移除一個或多個類。toggleClass():對類進行新增/移除的切換。css():設定或回傳樣式屬性。$(selector).css("propertyname"); // 回傳 CSS 屬性的值
$(selector).css("propertyname","value"); // 設定單一 CSS 屬性
$(selector).css({"propertyname":"value1","propertyname":"value"}); // 一次設定多個屬性
width() / height():回傳或設定元素寬高(不含內距、邊框、外距)。innerWidth() / innerHeight():包含內距的寬高。outerWidth() / outerHeight():包含內距與邊框的寬高。outerWidth(true) / outerHeight(true):包含內距、邊框與外距的寬高。$("span").parent(); // 回傳直接父元素
$("span").parents(); // 回傳所有祖先元素
$("span").parents("ul"); // 回傳祖先中為 ul 的元素
$("span").parentsUntil("div"); // 回傳兩個指定元素之間的所有祖先
$("selector").children(); // 回傳所有直接子元素
$("div").children("p.1"); // 回傳 class 為 1 的直接子 p 元素
$("div").find("*"); // 回傳 div 的所有後代
$("div").find("span"); // 回傳 div 後代中所有的 span
$("h2").siblings(); // 回傳 h2 的所有同胞元素
$("h2").siblings("p"); // 回傳同胞中的 p 元素
$("h2").next(); // 回傳下一個同胞元素
$("h2").nextAll(); // 回傳後續所有同胞元素
$("h2").nextUntil("h6"); // 回傳 h2 與 h6 之間的所有同胞
// prev()、prevAll()、prevUntil() 則是往回方向查找
$("div p").first(); // 選取第一個 p 元素
$("div p").last(); // 選取最後一個 p 元素
$("p").eq(1); // 選取索引為 1 的元素(索引從 0 開始)
$("p").filter(".intro");// 回傳帶有 intro 類的 p 元素
$("p").not(".intro"); // 回傳不帶 intro 類的 p 元素
AJAX 是一門「在不重新載入整個頁面的情況下,與伺服器交換資料並局部更新網頁」的技術,能大幅提升使用者體驗。
$(selector).load(URL,data,callback); // 從伺服器載入資料並放入被選元素
$("#div1").load("demo_test.txt #p1"); // 載入指定檔案中 id 為 p1 的元素內容
下面的範例會在 load() 完成後依結果顯示提示:
$("button").click(function(){
$("#div1").load("demo_test.txt",function(responseTxt,statusTxt,xhr){
if(statusTxt=="success")
alert("外部內容加載成功!");
if(statusTxt=="error")
alert("Error: "+xhr.status+": "+xhr.statusText);
});
});
responseTxt:呼叫成功時的結果內容。statusTxt:呼叫的狀態。xhr:包含 XMLHttpRequest 物件。用於透過 HTTP GET 或 POST 請求向伺服器取得資料:
$.get(URL,callback);
$("button").click(function(){
$.get("demo_test.asp",function(data,status){
alert("Data: " + data + "\nStatus: " + status);
});
});
$.post(URL,data,callback);