jQuery 物件裡有一個類陣列的元素包裝集,它像 JavaScript 陣列一樣帶有 length 屬性,因此被稱為類陣列。以下把這個包裝集上可用的操作方法整理一遍,看看 jQuery 替我們準備了哪些工具。
size():回傳包裝集中的元素個數,例如 $('a').size() 就是連結元素的數量。
get(index):不指定 index 時,回傳包裝集中所有元素組成的陣列;指定 index 時,回傳該下標對應的元素。例如 $('img[title]').get(0) 取回帶 title 屬性的第一個 img 元素,等效於 $('img[title]')[0]。
index(elem):回傳元素 elem 在包裝集中的下標,找不到則回傳 -1。
add(String|elem|Array):把參數中的元素加入包裝集。若參數是 jQuery 選擇器,所有匹配物件都會被加入;若是 HTML 字串,則先經 clean 處理成元素陣列再加入;若是 DOM 元素或元素陣列,則直接加入。回傳的是添加後的包裝集。例如 $('img[alt]','img[title]') 等效於 $('img[alt]').add('img[title]'),結果是帶 alt 或帶 title 屬性的 img 元素。
not(String|elem|Array):把滿足參數條件的元素從包裝集中移除。參數只能是篩選表達式,即以「[」或「:」開頭的寫法。例如 $('img[title]').not('title*=puy') 會保留帶 title 屬性、且 title 內容不含 puy 的 img 元素。回傳篩選後的包裝集。
filter(String|function):傳入字串時,該表達式須為篩選表達式,用來刪除所有不匹配的元素;傳入函式時,包裝集中每個元素都會呼叫該函式,回傳 false 者被移除,函式內可用 this 參照當前元素。例如 $('td').filter(function(){return this.innerHTML.match(/^"d+$/)}) 會取回內容為數字的 td 元素。
slice(begin,end):建立並回傳一個新的包裝集,內容是原包裝集的連續片段,第一個元素位於 begin 位置,最後一個元素是 end 位置的前一個;省略 end 則延伸到末尾。例如 $('*').slice(2,3) 先選取頁面上所有元素,再取出原集合第三個元素組成新集合。注意它與 $('*').get(2) 不同:get 回傳元素本身,slice 回傳包裝集,因此仍可用包裝集的方法操作。
children():回傳原始包裝集中所有元素的不同子元素組成的新包裝集(不含文字節點),例如 $('div').children()。指定參數時,該參數為篩選表達式。
contents():回傳原始包裝集元素的內容組成的新包裝集,可以包含文字節點。此方法不接受參數過濾。
next():回傳每個元素唯一的下一個兄弟元素組成的新包裝集。例如 $('div#someDiv').next() 取回 id 為 someDiv 的 div 之後那個兄弟元素。指定參數時,該參數為篩選表達式。
nextAll():回傳所有後續兄弟元素組成的新包裝集,例如 $('div#someDiv').nextAll()。參數同樣可作為篩選表達式。
parent():回傳所有元素唯一的直接父元素組成的新包裝集,可帶篩選參數。
parents():回傳所有元素的祖先元素組成的新包裝集,可帶篩選參數。
prev():回傳每個元素唯一的前一個兄弟元素組成的新包裝集,可帶篩選參數。
prevAll():回傳所有前面的兄弟元素組成的新包裝集,可帶篩選參數。
siblings():回傳所有唯一的兄弟元素組成的新包裝集,可帶篩選參數。
find(String):回傳包裝集中與傳入選擇器匹配的所有後代元素組成的新包裝集。
contains(text):回傳包含指定文字字串的元素組成的新包裝集。
is(String):包裝集中若含有與字串匹配的元素則回傳 true,否則回傳 false。
clone(copyHandle):參數為 true 時連事件一起複製,否則不複製事件,結果形成一個新的包裝集。
end():在 jQuery 命令鏈中呼叫,用來退回上一個包裝集。
andSelf():合併命令鏈中最近產生的兩個包裝集。
包裝集相關的操作就整理到這裡,若有疏漏之處,歡迎指正,方便大家互相參考。