取得元素之後,下一步往往是「往上、往下、往旁邊找」。jQuery 把這些遍歷操作整理成一組語意清楚的方法,以下逐一說明並附上可驗證的範例。
將符合表達式的元素加入目前的集合,可用來串接兩組查詢結果。參數可以是選擇器字串、DOM 元素,或元素陣列。
$("p").add("span")
// [ <p>Hello</p>, <span>Hello Again</span> ]
$("p").add("<span>Again</span>") // 動態產生新元素並加入
$("p").add(document.getElementById("a"))
取得每個符合元素的所有「第一層」子元素。這點要特別注意:parents() 會回頭找所有祖先,而 children() 只往下看一層,不含更深的後代。
$("div").children() // 所有子元素
$("div").children(".selected") // 只取 class 為 selected 的子元素
取得元素內部所有子節點,包含文字節點;若元素是 iframe,則會取得它的文件內容。
// 把段落中的文字節點(非元素節點)加粗
$("p").contents().not("[@nodeType=1]").wrap("<b/>");
// 往空 iframe 裡塞內容
$("iframe").contents().find("body").append("I'm in an iframe!");
找出目前元素的後代中符合表達式的部分,表達式支援 CSS 1-3 的選擇器語法。
$("p").find("span") // 等同 $("p span")
只回傳緊鄰在後面的同輩元素,不是全部。要全部的話用 nextAll()。
$("p").next() // 每個 p 後面緊鄰的同輩
$("p").next(".selected") // 且必須是 class 為 selected
$("div:first").nextAll().addClass("after");
$("p").parent()
$("p").parent(".selected")
取得全部祖先元素,但不含根元素。
$("span").parents()
$("span").parents("p") // 只取 p 類的祖先
$("p").prev() // 前面緊鄰的同輩
$("p").prev(".selected") // 且 class 為 selected
$("div:last").prevAll().addClass("before");
$("div").siblings()
$("p").siblings(".selected")
在篩選或遍歷之後,若想把先前選到的元素一起納入,這個方法很好用。
$("div").find("p").andSelf().addClass("border");
// 結果是 div 與其內部的 p 都拿到 border 樣式
回到最近一次「破壞性操作」之前的狀態。所謂破壞性操作,指的是任何會改變目前 jQuery 集合的動作,包括 add、andSelf、children、filter、find、map、next、nextAll、not、parent、parents、prev、prevAll、siblings、slice,以及操作類的 clone。若之前沒有這類操作,則回傳空集合。
$("p").find("span").end() // 回到只選 p 的狀態
把 find() 與 end() 配起來用,就能在同一條鏈上先鑽進子元素、再退回外層,不必重複寫選擇器,程式碼讀起來也更像一句自然語言。