jQuery 遍歷 parentsUntil() 方法

jQuery 參考手冊 遍歷

parentsUntil() 獲得當前匹配元素集合中每個元素的祖先元素，直到（但不包括）被選擇器、DOM 節點或 jQuery 對象匹配的元素。

1. 語法 1

.parentsUntil(selector,filter)

2. 語法 2

.parentsUntil(element,filter)

如果給定一個表示 DOM 元素集合的 jQuery 對象，.parentsUntil() 方法允許我們在 DOM 樹中搜索這些元素的祖先元素，直到遇到被選擇器（傳遞到方法中的參數）匹配的元素為止。返回的 jQuery 對象包含所有祖先元素，但不包括由 .parentsUntil() 方法規定的選擇器匹配的那個元素。

如果不匹配或未應用選擇器，則將選區所有祖先元素；在這種情況下，該方法選取的元素與未提供選擇器時的 .parents() 相同。

對于 jQuery 1.6，DOM 節點或 jQuery 對象，而不是選擇器，可用作 .parentsUntil() 方法的第一個參數。

該方法接受可選的選擇器表達式作為其第二參數。如果應用這個參數，則將通過檢測元素是否匹配該選擇器對元素進行篩選。

3. 范例

查找 <li class="item-a"> 的祖先元素，直到 <ul class="level-1">，并將它們設置為紅色背景。同時，找到 <li class="item-2"> 的所有類名為 "yes" 的祖先元素，直到 <ul class="level-1">，然戶為它們設置藍色邊框：

$("li.item-a").parentsUntil(".level-1")
  .css("background-color", "red");
$("li.item-2").parentsUntil( $("ul.level-1"), ".yes" )
  .css("border", "3px solid blue");

jQuery 參考手冊 遍歷