mirror of
https://github.com/Hopiu/jquery-mobile.git
synced 2026-03-18 15:00:23 +00:00
111 lines
No EOL
4.9 KiB
HTML
111 lines
No EOL
4.9 KiB
HTML
<!DOCTYPE html>
|
|
<html lang='en'><head><meta http-equiv='content-type' content='text/html; charset=UTF-8' /></head><body>
|
|
<div class="ui-page">
|
|
<div class="ui-header">
|
|
<h1>.find()</h1>
|
|
|
|
</div>
|
|
<div class="ui-content ui-body ui-body-c" id="find1">
|
|
<h2 class="jq-clearfix roundTop section-title">
|
|
<span class="name">.find( selector )</span> <span class="returns">Returns: <a class="return" href="http://docs.jquery.com/Types#jQuery">jQuery</a></span>
|
|
</h2>
|
|
<div class=" entry-details">
|
|
<p class="desc"><strong>Description: </strong>Get the descendants of each element in the current set of matched elements, filtered by a selector.</p>
|
|
<ul class="signatures"><li class="signature" id="find-selector">
|
|
<h4 class="name">
|
|
<span class="versionAdded">version added: <a href="/category/version/1.0/">1.0</a></span>.find( selector )</h4>
|
|
<p class="arguement"><strong>selector</strong>A string containing a selector expression to match elements against.</p>
|
|
</li></ul>
|
|
<div class="longdesc">
|
|
<p>Given a jQuery object that represents a set of DOM elements, the <code>.find()</code> method allows us to search through the descendants of these elements in the DOM tree and construct a new jQuery object from the matching elements. The <code>.find()</code> and <code>.children()</code> methods are similar, except that the latter only travels a single level down the DOM tree.</p>
|
|
<p>The method accepts a selector expression of the same type that we can pass to the $() function. The elements will be filtered by testing whether they match this selector.</p>
|
|
<p>Consider a page with a basic nested list on it:</p>
|
|
<pre>
|
|
<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>
|
|
</pre>
|
|
<p>If we begin at item II, we can find list items within it:</p>
|
|
<pre>$('li.item-ii').find('li').css('background-color', 'red');</pre>
|
|
<p>The result of this call is a red background on items A, B, 1, 2, 3, and C. Even though item II matches the selector expression, it is not included in the results; only descendants are considered candidates for the match.</p>
|
|
<p>As discussed in “The jQuery Factory Function” section above, selector context is implemented with the <code>.find()</code> <code>method;</code> therefore, <code>$('li.item-ii').find('li')</code> is equivalent to <code>$('li', 'li.item-ii')</code>.</p>
|
|
<blckquote>Unlike in the rest of the tree traversal methods, the selector expression is required in a call to <code>.find()</code>. If we need to retrieve all of the descendant elements, we can pass in the universal selector <code>'*'</code> to accomplish this.</blckquote>
|
|
</div>
|
|
<h3>Examples:</h3>
|
|
<div id="entry-examples" class="entry-examples">
|
|
<div id="example-0">
|
|
<h4>Example: <span class="desc">Starts with all paragraphs and searches for descendant span elements, same as $("p span")</span>
|
|
</h4>
|
|
<pre><code class="example demo-code"><!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<script src="http://code.jquery.com/jquery-latest.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></code></pre>
|
|
<h4>Demo:</h4>
|
|
<div class="demo code-demo"></div>
|
|
</div>
|
|
<div id="example-1">
|
|
<h4>Example: <span class="desc">Add spans around each word then add a hover and italicize words with the letter t.</span>
|
|
</h4>
|
|
<pre><code class="example demo-code"><!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<style>
|
|
p { font-size:20px; width:200px; cursor:default;
|
|
color:blue; font-weight:bold; margin:0 10px; }
|
|
.hilite { background:yellow; }
|
|
</style>
|
|
<script src="http://code.jquery.com/jquery-latest.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></code></pre>
|
|
<h4>Demo:</h4>
|
|
<div class="demo code-demo"></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
</body></html> |