uTools-Manuals/docs/jQuery/jQuery.contains.html
2019-04-21 11:50:48 +08:00

60 lines
2.9 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<article class="" id="post-">
<header class="entry-header">
<h1 class="entry-title">jQuery.contains()</h1>
<div class="entry-meta">
所属分类:<span class="category"><a href="/category/utilities/">工具类</a></span>
<span class="pull-right">英文文档:<a href="https://api.jquery123.com/jQuery.contains/" target="_blank">jQuery.contains()</a></span>
</div><!-- .entry-meta -->
</header><!-- .entry-header -->
<!-- .entry-header -->
<div class="entry-content">
<article class="entry method" id="jQuery-contains1"><h2 class="section-title">
<span class="name">jQuery.contains( container, contained )</span><span class="returns">返回: <a href="/Types/#Boolean">Boolean</a></span>
</h2>
<div class="entry-wrapper">
<p class="desc"><strong>描述: </strong>
检查一个DOM元素是另一个DOM元素的后代。</p>
<ul class="signatures"><li class="signature" id="jQuery-contains-container-contained">
<h4 class="name">
<span class="version-details">添加的版本: <a href="/category/version/1.4/">1.4</a></span>jQuery.contains( container, contained )</h4>
<ul>
<li>
<div><strong>container</strong></div>
<div>类型: <a href="/Types/#Element">Element</a>
</div>
<div>DOM元素作为容器可以包含其他元素</div>
</li>
<li>
<div><strong>contained</strong></div>
<div>类型: <a href="/Types/#Element">Element</a>
</div>
<div>DOM元素可能被其他元素所包含</div>
</li>
</ul>
</li></ul>
<div class="longdesc" id="entry-longdesc">
<p>如果第二个参数所提供的DOM元素是第一个参数DOM元素的后裔那么<code>$.contains()</code> 方法返回<code>true</code>,无论是直接的子元素或者是后代元素。否则,返回<code>false</code>。只支持 <em>element</em> 节点;如果第二个参数是一个文本或注释节点,<code>$.contains()</code>将返回 <code>false</code></p>
<blockquote>
<p><strong>注意:</strong> 第一个参数<em>必须</em>是一个DOM元素不是一个jQuery对象或普通的JavaScript对象。</p>
</blockquote>
</div>
<section class="entry-examples" id="entry-examples"><header><h2 class="underline">例子:</h2></header><div class="entry-example" id="example-0">
<h4><span class="desc">检测一个元素是否在另一个元素之内。 不支持文档和注释节点。</span></h4>
<div class="syntaxhighlighter javascript ">
<table>
<tbody>
<tr>
<td class="gutter">
<div class="line n1">1</div>
<div class="line n2">2</div>
</td>
<td class="code">
<pre><div class="container"><div class="line"><code>$.contains( document.documentElement, document.body ); <span class="comment">// true</span></code></div></div><div class="container"><div class="line"><code>$.contains( document.body, document.documentElement ); <span class="comment">// false</span></code></div></div></pre>
</td>
</tr>
</tbody>
</table>
</div>
</div></section>
</div></article> </div>
</article>