寫 jQuery 的典型流程是:產生 jQuery 物件 A、操作 A;產生物件 B、操作 B……但如果 A 與 B 之間存在某種結構關係(父子、兄弟),一個個去 $(selector) 重新選取就顯得冗餘。為此 jQuery 提供了一整套「更改物件」的方法,讓流程變成:產生 A、操作 A;更改為 B、操作 B……
一個 jQuery 物件既要連續做 N 次操作,中間又穿插 M 次物件切換,直覺做法是把每一步的結果存進變數。但每步都宣告一個新變數同樣麻煩。jQuery 的解法是:操作型方法執行後回傳物件本身,於是能一路接下去寫,直到需要切換物件時才呼叫更改型方法,回傳新物件後再繼續。
這其實就是函數式思維的體現。左右對比一下就很清楚:
| 一般調用 | 鏈式調用 |
|---|---|
|
a=$("div"); a.addClass("class"); b=a.children("ul"); b.show(); c=a.siblings(); c.removeClass("class"); |
$("div").addClass("class") .children("ul").show().end() .siblings().removeClass("class"); |
注意鏈式版本中那個 .end()——它的作用是「回到上一次更改之前的物件」,讓你能從子元素跳回原本的 div 繼續操作。這是鏈式寫法能保持可讀的關鍵機制。
| 方法 | 說明 | 等價寫法 |
|---|---|---|
children(selector) | 在後代元素中選取符合 selector 者。不帶參數時等同 children(*),即選取所有直接子元素。 | $(s1).children(s2) ≡ $(s1>s2) |
find(selector) | 在所有後代元素中選取符合者。不帶參數時等同 find(":not(*)"),不會選到任何後代。若參數使用基本過濾選擇器,是在每個後代元素上分別過濾,而非對全體結果做一次過濾。 | $(s1).find(s2) ≈ $(s1 s2) |
contents() | 選取子元素與文字節點(含註解節點)。 | — |
| 方法 | 說明 |
|---|---|
parent(selector) | 在父元素中選取符合者。不帶參數等同 parent("*")。 |
parents(selector) | 在祖先元素中選取符合者。不帶參數等同 parents("*")。 |
parentsUntil(selector) | 向上選取祖先,直到遇到符合 selector 的元素為止(不含該元素)。不帶參數等同 parents()。 |
offsetParent s() | 選取最近的祖先定位元素,且该元素的 CSS display 不能為 none。定位元素指 CSS position 不為 static 者。 |
closest(selector) | 從自身開始向上,選取符合 selector 的最近元素。與 parents() 的差別是「包含自己」且「只取一個」。 |
| 方法 | 說明 | 等價寫法 |
|---|---|---|
next(selector) | 在後方第一個兄弟元素中選取符合者。不帶參數等同 next("*")。 | $(s1).next(s2) ≡ $(s1+s2) |
prev(selector) | 在前方第一個兄弟元素中選取符合者。不帶參數等同 prev("*")。 | — |
nextAll(selector) | 在後方所有兄弟元素中選取符合者。 | $(s1).nextAll(s2) ≡ $(s1~s2) |
prevAll(selector) | 在前方所有兄弟元素中選取符合者。 | — |
siblings(selector) | 在所有兄弟元素中選取符合者。不帶參數等同 siblings("*")。 | — |
nextUntil(selector) | 向後選取兄弟元素,直到遇到符合 selector 者(不含該元素)。不帶參數等同 nextAll()。 | — |
prevUntil(selector) | 向前選取兄弟元素,直到遇到符合 selector 者(不含該元素)。不帶參數等同 prevAll()。 | — |
| 方法 | 說明 | 等價寫法 |
|---|---|---|
add(selector) | 在原有集合的基礎上,加入符合 selector 的元素。 | $(s1).add(s2) ≡ $(s1, s2) |
andSelf() | 後代、祖先、兄弟類操作會選到「原有元素以外」的集合,此方法可把原元素與操作結果合併。(1.8 起建議改用 addBack()) | — |
| 方法 | 說明 | 等價寫法 |
|---|---|---|
eq(index) | 篩選索引等於 index 的元素。索引從 0 正向計算,也可從 -1 倒數,兩者不可混用。 | $(s).eq(i) ≡ $(s:eq(i)) |
first() | 篩選第一個元素。 | $(s).first() ≡ $(s:first) |
last() | 篩選最後一個元素。 | $(s).last() ≡ $(s:last) |
slice(start, [end]) | 篩選索引從 start 到 end-1 的元素。不傳 end 則取 start 之後全部。 | — |
filter(selector) | 從現有集合中篩選符合 selector 者。 | — |
filter(fn(index)) | 以函數篩選:對索引為 index 的元素,函數回傳 true 則保留,否則排除。可用來實作 even / odd / gt / lt 等自訂規則。 | — |
not(selector) | 從現有集合中排除符合 selector 者。 | $(s1).not(s2) ≡ $(s1:not(s2)) |
not(fn(index)) | 以函數篩選:回傳 true 的元素被排除,其餘保留。 | — |
has(selector) | 篩選出「擁有符合 selector 的後代元素」的元素。 | $(s1).has(s2) ≡ $(s1:has(s2)) |
| 方法 | 說明 |
|---|---|
end() | 把選取結果還原到上一次更改之前。若要還原多層更改則需多次呼叫,最終會回傳空集合。 |
實務上的建議是:鏈式寫法雖然精簡,但超過三、四層就該斷行或改用變數保存中間結果。鏈太長不僅難讀,除錯時也不方便中斷點觀察——畢竟程式碼是寫給人看的,只是剛好能執行。