返回值:jQueryparents([selector])

查找当前匹配元素集合中每个元素的所有祖先元素,可以提供一个可选的选择器。

若一个 jQuery 对象代表了一个 DOM 元素集合,.parents() 方法允许我们在 DOM 树中查找集合中这些元素的祖先元素,并将匹配的元素按照它们的直接父元素顺序创建一个新的 jQuery 对象。元素的返回顺序是按照由近及远的原则排列的。.parents() .parent() 方法很类似,只是后者仅在 DOM 树中的单一层次向上遍历。

该方法还可以接受一个可选的选择器表达式,该选择器表达式可以是任何可传给 $() 函数的选择器表达式。如果提供了选择器表达式,那么会先测试该元素是否满足匹配的选择器表达式。

例如,在页面上有如下一个基本的嵌套列表:

<ul class="level-1">
  <li class="item-i">I</li>
  <li class="item-ii">II
    <ul class="level-2">
      <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>

如果我们从 item A 开始,我们可以查找它的所有祖先:

$('li.item-a').parents().css('background-color', 'red');

其结果是,level-2 列表, item II, 和 level-1 列表 (延着 DOM 树向上直到 <html> 元素) 的背景色变成了红色。由于我们没有提供选择器表达式,所以所有的祖先元素都是返回的 jQuery 对象的一部分。如果我们提供了选择器,那么只有满足选择器的元素才会被包含在结果中。

示例:

查找每个 b 标签的所有父元素。

<!DOCTYPE html>
<html>
<head>
<style>
  b, span, p, html body {
    padding: .5em;
    border: 1px solid;
  }
  b { color:blue; }
  strong { color:red; }
  </style>
<script src="jquery.min.js"></script>
</head>
<body>

<div>
    <p>
      <span>
        <b>My parents are: </b>
      </span>

    </p>
  </div>

<script>


var parentEls = $("b").parents()
            .map(function () { 
                  return this.tagName; 
                })
            .get().join(", ");
$("b").append("<strong>" + parentEls + "</strong>");



</script>
</body>
</html>

演示:

示例:

点击元素,查找每个 span 标签的所有独一无二的 div 父元素。

<!DOCTYPE html>
<html>
<head>
<style>

  p, div, span {margin:2px; padding:1px; }
  div { border:2px white solid; }
  span { cursor:pointer; font-size:12px; }
  .selected { color:blue; }
  b { color:red; display:block; font-size:14px; }
  </style>
<script src="jquery.min.js"></script>
</head>
<body>

<p>
    <div>
      <div><span>Hello</span></div>
      <span>Hello Again</span>

    </div>
    <div>
      <span>And Hello Again</span>
    </div>
  </p>

  <b>Click Hellos to toggle their parents.</b>

<script>


function showParents() {
  $("div").css("border-color", "white");
  var len = $("span.selected")
                   .parents("div")
                   .css("border", "2px red solid")
                   .length;
  $("b").text("Unique div parents: " + len);
}
$("span").click(function () {
  $(this).toggleClass("selected");
  showParents();
});

</script>
</body>
</html>

演示: