.find()| jqueryAPI 2.2 中文手册- AspRain.cn 致力于Web开发技术翻译整理

jQuery API 2.2.0

.find()

分类:遍历 > 树遍历

返回: jQuery

.find( selector )

描述:获得当前所匹配的元素集合中每个元素的后代元素,用一个选择器、jQuery对象,或者元素作筛选。

加入于: 1.0
.find( selector )
  • selector
    类型:Selector
    一个字符串,它包含了一个选择器表达式,用来匹配所针对的元素。
加入于: 1.6
.find( element )
  • element
    类型:Element or jQuery
    一个元素或者jQuery对象,用来匹配所针对的元素。

给定一个jQuery对象,代表了一个DOM元素的集合,.find()方法允许我们搜遍这些元素在DOM树中的后代元素,并从匹配的元素构成一个新的jQuery对象。.find()方法和.children()方法很相似,除了后者只能遍历DOM树中的一个层级。

.find()方法的第一种签名接受一个选择器表达式,与我们可以传递给$()函数的选择器表达式类型相同。元素将被筛选以测试它们是否匹配该选择器。

设想一个网页带有一个基本的嵌套列表:

<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>

如果我们从项目II开始,我们可以在它里面找到列表项目:

$( "li.item-ii" ).find( "li" ).css( "background-color", "red" );

这个调用的结果是在项目A、B、1、2、3和C上有一个红色的背景。虽然项目II匹配选择器表达式,但是它不包含在结果中;只有后代元素可以考虑作为匹配的候选项。

与别的树遍历方法不同,该选择器表达式需要在.find()中调用。如果我们需要检索所有的后代元素,我们可以传入普遍选择器'*'以完成这。

选择器上下文是用.find()方法实现的;因此,$( "li.item-ii" ).find( "li" )等同于$( "li", "li.item-ii" )

自从jQuery 1.6开始,我们可以用一个给定的jQuery集合或元素筛选选区。用和上面相同的嵌套列表,如果你开始于:

var allListElements = $( "li" );

然后传入该jQuery对象以查找:

$( "li.item-ii" ).find( allListElements );

这将返回一个jQuery集合,它只包含了作为项目II的后代元素的列表元素:

类似地,也可以传入一个元素以查找它:

var item1 = $( "li.item-1" )[ 0 ];
$( "li.item-ii" ).find( item1 ).css( "background-color", "red" );

这个调用的结果是项目1的背景变红色:

示例

从每个段落文本开始,搜索后代元素中的<span>元素,与$( "p span" )相同。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>find demo</title>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<p><span>Hello</span>, how are you?</p>
<p>Me? I'm <span>good</span>.</p>
 
<script>
$( "p" ).find( "span" ).css( "color", "red" );
</script>
 
</body>
</html>

演示结果

一个选区使用一个所有<span>标签的jQuery集合。只有在一个<p>标签内部的<span>变成红色,与此同时别的都留作蓝色。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>find demo</title>
  <style>
  span {
    color: blue;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<p><span>Hello</span>, how are you?</p>
<p>Me? I'm <span>good</span>.</p>
<div>Did you <span>eat</span> yet?</div>
 
<script>
var spans = $( "span" );
$( "p" ).find( spans ).css( "color", "red" );
</script>
 
</body>
</html>

演示结果

在每个单词周围添加一个<span>,然后对带字母t的<span>添加一个悬停和斜体单词。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>find demo</title>
  <style>
  p {
    font-size: 20px;
    width: 200px;
    color: blue;
    font-weight: bold;
    margin: 0 10px;
  }
  .hilite {
    background: yellow;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<p>
  When the day is short
  find that which matters to you
  or stop believing
</p>
 
<script>
var newText = $( "p" ).text().split( " " ).join( "</span> <span>" );
newText = "<span>" + newText + "</span>";
 
$( "p" )
  .html( newText )
  .find( "span" )
    .hover(function() {
      $( this ).addClass( "hilite" );
    }, function() {
      $( this ).removeClass( "hilite" );
    })
  .end()
  .find( ":contains('t')" )
    .css({
      "font-style": "italic",
      "font-weight": "bolder"
    });
</script>
 
</body>
</html>

演示结果

如果网页上不能运行示例,请点击http://www.asprain.cn/jQueryAPI/find.htm查看示例。

如果你觉得本文档对你有用,欢迎给翻译作者支付宝打赏,支持翻译作者源源不断翻译更多有用的技术文档。