這份筆記把 jQuery 最常翻的四個主題——選擇器、DOM 操作、CSS-DOM、事件與動畫——整理成可隨查的對照表,適合當作日常開發的參考。
先準備好文件就緒的寫法,兩種都可以:
$(document).ready(function(){});
$(function(){});
若某個變數存的是 jQuery 物件,慣例是在變數名前加上 $,例如 var $variable = jQuery物件。另外,判斷元素是否存在時,要用 length 或索引取值,而不是直接當布林值:
if ($("#tt").length > 0) {}
if ($("#tt")[0]) {}
$("#test") // id 為 test
$(".test") // class 為 test 的所有元素
$("p") // 所有 p 標籤
$("*") // 頁面全部元素
$("span,#two") // 所有 span 以及 id 為 two 的元素
$("div span") // div 內所有 span(含後代)
$("parent>children") // parent 底下第一層的 children
$('.one+span') // class 為 one 的下一個 span
$('.one~div') // class 為 one 之後的所有 div 兄弟
後兩者可改用方法鏈表達,語意更清楚:
$('.one+span') 等價於 $(".one").next("span")
$('.one~div') 等價於 $(".one").nextAll("div")
$(".one").siblings("div") // 不論前後,所有兄弟 div
基本過濾:
$("div:first") // 第一個 div
$("div:last") // 最後一個 div
$("input:not(.myClass)") // class 不是 myClass 的 input
$("input:even") // 索引為偶數
$("input:odd") // 索引為奇數
$("input:eq(1)") // 索引等於 1
$("input:gt(1)") // 索引大於 1
$("input:lt(1)") // 索引小於 1
$(":header") // 所有 h1~h6
$("div:animated") // 正在執行動畫的 div
內容過濾:
$("div:contains('我')") // 文字含「我」
$("div:empty") // 無子節點與文字
$("div:has(p)") // 內含 p 元素
$("div:parent") // 有子節點或文字
可見性過濾:
$(":hidden") // 所有不可見元素
$("input:hidden") // 只看 input,可避免誤選
$("div:visible") // 所有可見 div
屬性過濾:
$("div[id]") // 有 id 屬性
$("div[title=test]") // title 等於 test
$("div[title!=test]") // title 不等於 test(沒有該屬性的也會被選到)
$("div[title^=test]") // title 以 test 開頭
$("div[title$=test]") // title 以 test 結尾
$("div[title*=test]") // title 含 test
$("div[id][title$='test']") // 多條件同時成立
這是最容易踩坑的地方。:eq(index) 只會回傳單一元素,索引從 0 起算;:nth-child(index) 則是替「每一個父元素」各自匹配,索引從 1 起算。:first、:last 同樣只回傳一個元素,而 :first-child、:last-child 是每個父元素各取一個。
$("ul li:first-child") // 每個 ul 的第一個 li
$("ul li:only-child") // 作為唯一子元素的 li
:nth-child() 的變化相當實用:
:nth-child(even) // 每個父元素下索引為偶數者
:nth-child(odd) // 索引為奇數者
:nth-child(2) // 索引等於 2 者
:nth-child(3n) // 3 的倍數(n 從 0 起)
:nth-child(3n+1) // 3n+1 形式
$("#form1 :enabled") // form1 內可用元素
$("#form2 :disabled") // form2 內停用元素
$("input:checked") // 已勾選
$("select :selected") // 已選取的選項
$(":input") // input、textarea、select、button
$(":text") // 單行文字框
$(":password") // 密碼框
$(":radio") // 單選鈕
$(":checkbox") // 核取方塊
$(":submit") // 送出鈕
$(":image") // 圖像鈕
$(":reset") // 重設鈕
$(":button") // 一般按鈕
$(":file") // 檔案上傳
$(":hidden") // 隱藏元素
DOM 可分為三層:DOM Core(與語言無關的核心標準)、HTML-DOM(HTML 專屬屬性,出現得比 Core 更早)、CSS-DOM(針對 style 的操作)。
六個方法成對出現,差別只在「誰呼叫誰」:
$("p").append("<b>你</b>") // <p>test <b>你</b></p>
$("<b>你</b>").appendTo("p") // 同上結果
$("p").prepend("<b>你</b>") // <p><b>你</b>test</p>
$("p").prependTo("<b>你</b>") // 同上結果
$("p").after("<b>你</b>") // 放在 p 後面
$("<b>你</b>").insertAfter("p") // 同上結果
$("p").before("<b>你</b>") // 放在 p 前面
$("<b>你</b>").insertBefore("p") // 同上結果
remove() // 連同子節點一起移除
empty() // 只清空內容
clone(true) // 複製並一併複製已綁定的事件
replaceWith("<a>test</a>")
$("<a>test</a>").replaceAll("p")
$("strong").wrap("<b></b>") // 逐一包裹
$("strong").wrapAll("<b></b>") // 全部包進同一個
$("strong").wrapInner("<b></b>") // 只包裹內部內容
attr() / removeAttr() // 讀寫與移除屬性
addClass() / removeClass("one two") // 增減 class
toggleClass() // 樣式上的重複切換
hasClass() // 判斷是否含某 class,等同 is(".one")
html() / text() / val() // 讀寫 HTML、文字與表單值
children() // 只看第一層子元素
next() // 後面緊鄰的同輩
prev() // 前面緊鄰的同輩
siblings() // 全部兄弟
closest() // 最近的符合祖先
另有 find()、filter()、nextAll()、prevAll()、parent()、parents() 等常用方法。
$(".one").css("color") // 讀取
$(".one").css("color", "red") // 單筆設定
$(".one").css({"opacity":"0.5","background-color":"blue"})
$(".one").height("20px") / $(".one").width("200px")
offset() // 相對於目前視窗的偏移,含 top 與 left
position() // 相對於最近的 relative/absolute 祖先的偏移
scrollTop() // 讀寫垂直捲動距離
scrollLeft() // 讀寫水平捲動距離
bind(type[, data], fn)
type 是事件類型(也可自訂名稱),data 會作為 event.data 傳入,fn 是處理函式。可以一次綁多個事件:
$("div").bind("mouseover mouseout", function(){
$(this).toggleClass("over");
});
hover(enter, leave) // 游標移入執行 enter,移出執行 leave
toggle(fn1, fn2, ...) // 連續單擊依序觸發各函式
當元素彼此嵌套且都綁了 click,點擊最內層時,外層元素的事件也會依序被觸發,方向是由內向外。要中止這個行為:
$('span').bind("click", function(event){
var txt = $(this).html() + "<p>內層 span 被點擊</p>";
$('#msg').html(txt);
event.stopPropagation(); // 停止冒泡
});
若要一併阻止表單預設行為,用 event.preventDefault(),或直接 return false。
unbind([type][, data]) // 移除事件
one(type, [data], fn) // 觸發一次後自動解除
速度關鍵字對應的固定毫秒數為:slow = 600、normal = 400、fast = 200。
show() / hide()
fadeIn() // 逐步降低不透明度直到消失
fadeOut() // 反向操作
slideDown() // 由上往下展開顯示
slideUp() // 收合隱藏
自訂動畫的語法為 animate(params, speed, callback):
params:樣式屬性與目標值的映射,例如 {property1:"value1", property2:"value2"}speed:速度,可選callback:動畫完成後執行的函式,可選把這幾張表存成書籤,寫的時候少翻好幾次文件。