parents

英['peərənts]   美['peərənts]  

##n.雙親（parent的名詞複數）

# until

英[ənˈtɪl]   美[ʌnˈtɪl]  

prep.到…為止;在…以前

#conj.到…為止，在…;直到以前直到以前直到之前; …才

jqueryparentUntil() 方法 語法

作用：parentsUntil() 取得目前符合元素集合中每個元素的祖先元素，直到（但不包含）被選擇器、DOM 節點或 jQuery 物件相符的元素。

語法1：.parentsUntil(selector,filter)

#參數：

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

語法2：.parentsUntil(element,filter)

參數：

參數說明
element    可選。 DOM 節點或 jQuery 對象，指示在何處停止對祖先元素的匹配。
filter    可選。字串值，包含用於匹配元素的選擇器表達式。

說明：如果給定一個表示DOM 元素集合的jQuery 對象，.parentsUntil() 方法允許我們在DOM 樹中搜尋這些元素的祖先元素，直到遇到被選擇器（傳遞到方法中的參數）所匹配的元素。傳回的 jQuery 物件包含所有祖先元素，但不包括由 .parentsUntil() 方法規定的選擇器所匹配的那個元素。如果不符合或未套用選擇器，則將選區所有祖先元素；在這種情況下，方法選取的元素與未提供選擇器時的 .parents() 相同。對於 jQuery 1.6，DOM 節點或 jQuery 對象，而不是選擇器，可用作 .parentsUntil() 方法的第一個參數。此方法接受可選的選擇器表達式作為其第二參數。如果應用此參數，則將透過偵測元素是否符合該選擇器對元素進行篩選。

jqueryparentUntil() 方法 範例

<!DOCTYPE html>
<html>
<head>
  <script type="text/javascript" src="http://apps.bdimg.com/libs/jquery/2.1.1/jquery.min.js"></script>
</head>

<body>
<ul class="level-1 yes">
  <li class="item-i">I</li>
  <li class="item-ii">II
    <ul class="level-2 yes">
      <li class="item-a">A</li>
      <li class="item-b">B
        <ul class="level-3">
          <li class="item-1">1</li>
          <li class="item-2">2</li>
          <li class="item-3">3</li>
        </ul>
      </li>
      <li class="item-c">C</li>
    </ul>
  </li>
  <li class="item-iii">III</li>
</ul>

<script>
$("li.item-a").parentsUntil(".level-1")
  .css("background-color", "red");

$("li.item-2").parentsUntil( $("ul.level-1"), ".yes" )
  .css("border", "3px solid blue");
</script>
</body>
</html>
執行實例 »

#點擊 "執行實例" 按鈕查看線上實例

#