三個方法都在找「同層的元素」,但涵蓋範圍不同。用錯會導致找不到元素,或者一次動到不該動的節點。以下逐一說明並附實例。
回傳匹配元素集合中,每個元素的所有唯一同輩元素。可用可選的表達式做篩選。
HTML:
<p>Hello</p> <div><span>Hello Again</span></div> <p>And Again</p>
jQuery:
$("div").siblings()
結果:
[ <p>Hello</p>, <p>And Again</p> ]
加上篩選條件,只取帶 .selected 的同輩:
<div><span>Hello</span></div>
<p class="selected">Hello Again</p>
<p>And Again</p>
$("div").siblings(".selected")
// [ <p class="selected">Hello Again</p> ]
取得每個元素緊接在後的那一個同輩元素,不是後面全部。想要全部要用 nextAll()。
HTML:
<p>Hello</p> <p>Hello Again</p> <div><span>And Again</span></div>
jQuery:
$("p").next()
// [ <p>Hello Again</p>, <div><span>And Again</span></div> ]
注意第一個 p 的下一個是第二個 p,第二個 p 的下一個是 div——每個元素各自取自己的下一個。
加篩選條件時有個容易誤解的地方:
<p>Hello</p>
<p class="selected">Hello Again</p>
<div><span>And Again</span></div>
$("p").next(".selected")
// [ <p class="selected">Hello Again</p> ]
這裡的篩選是「先取下一個,再檢查它是否符合條件」。如果下一個元素不符合,結果就是空集合,不會繼續往後找。這一點與許多人預期不同,實務上要留意。
HTML:
<div></div> <div></div> <div></div> <div></div>
jQuery:
$("div:first").nextAll().addClass("after");
// [ <div class="after"></div>, <div class="after"></div>, <div class="after"></div> ]
需求是刪除第一個 tr 之後的所有列,然後重新產生。我最初寫成:
$(".rili_tab01 tr:first").siblings.remove(); // ← 少了括號
結果第一步看似完成,重建時卻出問題。原因很單純:siblings 是函式,不加括號等於沒呼叫,那行程式碼實際上什麼都沒做(只是取到函式物件本身)。正確寫法:
$(".rili_tab01 tr:first").siblings().remove();
var retRow = "<tr><td>" + ret["eventTime"] + "</td>"
+ "<td>" + ret["eventCountry"] + "</td>"
+ "<td>" + ret["eventContent"] + "</td></tr>";
$(".rili_tab01 tr:last").after(retRow);
這個案例裡 next().remove() 也是可行的寫法,但它只會移除「第一列的下一列」這一列,其餘的列都還在:
$(".rili_tab01 tr:first").next().remove(); // 只刪掉第 2 列
若真的要用 next 系列達到相同效果,得寫成 nextAll().remove()。這正是釐清三者差異的實用價值——siblings() 取全部同輩、next() 只取下一個、nextAll() 取後面全部,選錯範圍就會產生這種「刪一半」的 bug。