實例

查找 <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");

親自試一試

定義和用法

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

語法 1

.parentsUntil(selector,filter)

參數	描述
selector	可選。字符串值，規(guī)定在何處停止對祖先元素進行匹配的選擇器表達式。
filter	可選。字符串值，包含用于匹配元素的選擇器表達式。

語法 2

.parentsUntil(element,filter)

參數	描述
element	可選。DOM 節(jié)點或 jQuery 對象，指示在何處停止對祖先元素的匹配。
filter	可選。字符串值，包含用于匹配元素的選擇器表達式。

詳細說明

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

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

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

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