nextUntil() 用來取得每個元素之後的所有同胞元素;若有傳入參數,則會在遇到該參數所匹配的元素時停止搜尋。回傳的新 jQuery 物件包含所有後續同胞,但不含被選擇器、DOM 節點或 jQuery 物件匹配到的元素。若不帶參數,則會選取所有後續同胞,此時效果等同 .nextAll()。
語法一:
.nextUntil(selector, filter)
語法二:
.nextUntil(element, filter)
詳細說明
當我們對代表 DOM 元素集合的 jQuery 物件呼叫 .nextUntil(),它會向後搜尋同胞元素,遇到參數匹配的元素即停止。回傳的結果不含被參數匹配到的元素。
若選擇器不匹配或未指定選擇器,則會選取所有後續同胞,此時與 .nextAll() 相同。
從 jQuery 1.6 起,除了選擇器,也可以把 DOM 節點或 jQuery 物件傳入 .nextUntil()。此外它接受一個可選的選擇器運算式作為第二參數,用來進一步篩選結果。
先看例子:
<dl> <dt id="term-1">term 1</dt> <dd>definition 1-a</dd> <dd class="abc">definition 1-b</dd> <dd>definition 1-c</dd> <dd>definition 1-d</dd> <dt id="term-2">term 2</dt> <dd>definition 2-a</dd> <dd>definition 2-b</dd> <dd>definition 2-c</dd> <dt id="term-3">term 3</dt> <dd>definition 3-a</dd> <dd>definition 3-b</dd> </dl>
$("#term-2").nextUntil("dt").css("background-color", "red");
結果如下:

幾個要注意的重點:
1、不包含自己,也就是上例不含 #term-2 本身。
2、不包含參數所匹配的元素,等於頭尾都去掉。
3、若選擇器不匹配或未指定選擇器,則會選取所有後續同胞。例如:
$("#term-2").nextUntil("dts").css("background-color", "red");
把原本的 dt 改成 dts 後,因為沒有元素匹配,結果如下:

$("#term-1").nextUntil("#term-3", "dd").css("color", "blue");
// 或者採用 DOM 元素:
//var term3 = document.getElementById("term-3");
//$("#term-1").nextUntil(term3, "dd").css("color", "blue");

$("#term-1").nextUntil("#term-3", ".abc").css("color", "blue");
結果如下:

再看不提供第二個篩選選擇器的例子:
$("#term-1").nextUntil("#term-3").css("color", "blue");
結果如下圖:

至於 prevUntil(),用法與 nextUntil() 幾乎相同,差別只在搜尋方向相反——一個往下,一個往上。