mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-06-08 15:04:05 +08:00
85 lines
9.2 KiB
HTML
85 lines
9.2 KiB
HTML
<article class="" id="post-">
|
|
<header class="entry-header">
|
|
<h1 class="entry-title">jQuery.uniqueSort()</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.uniqueSort/" target="_blank">jQuery.uniqueSort()</a></span>
|
|
</div><!-- .entry-meta -->
|
|
</header><!-- .entry-header -->
|
|
<article class="entry method" id="jQuery-uniqueSort1"><h2 class="section-title">
|
|
<span class="name">jQuery.uniqueSort( array )</span><span class="returns">Returns: <a href="http://api.jquery.com/Types/#Array">Array</a></span>
|
|
</h2>
|
|
<div class="entry-wrapper">
|
|
<p class="desc"><strong>Description: </strong>Sorts an array of DOM elements, in place, with the duplicates removed. Note that this only works on arrays of DOM elements, not strings or numbers.</p>
|
|
<ul class="signatures"><li class="signature">
|
|
<h4 class="name">
|
|
<span class="version-details">version added: <a href="/category/version/1.12-2.2/">1.12-2.2</a></span><a href="#jQuery-uniqueSort-array" id="jQuery-uniqueSort-array"><span class="icon-link"></span>jQuery.uniqueSort( array )</a>
|
|
</h4>
|
|
<ul><li>
|
|
<div><strong>array</strong></div>
|
|
<div>Type: <a href="http://api.jquery.com/Types/#Array">Array</a>
|
|
</div>
|
|
<div>The Array of DOM elements.</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
<div class="longdesc" id="entry-longdesc">
|
|
<p>The <code>$.uniqueSort()</code> function searches through an array of objects, sorting the array, and removing any duplicate nodes. A node is considered a duplicate if it is the <em>exact same</em> node as one already in the array; two different nodes with identical attributes are not considered to be duplicates. This function only works on plain JavaScript arrays of DOM elements, and is chiefly used internally by jQuery. You probably will never need to use it.</p>
|
|
<p>Prior to jQuery 3.0, this method was called <code><a href="/jQuery.unique/">jQuery.unique()</a></code>.</p>
|
|
<p>As of jQuery 1.4 the results will always be returned in document order.</p>
|
|
</div>
|
|
<section class="entry-examples" id="entry-examples"><header><h2>Example:</h2></header><div class="entry-example" id="example-0">
|
|
<p>Removes any duplicate elements from the array of divs.</p>
|
|
<div class="syntaxhighlighter xml">
|
|
<table>
|
|
<tbody>
|
|
<tr>
|
|
<td class="gutter">
|
|
<div class="line n1">1</div>
|
|
<div class="line n2">2</div>
|
|
<div class="line n3">3</div>
|
|
<div class="line n4">4</div>
|
|
<div class="line n5">5</div>
|
|
<div class="line n6">6</div>
|
|
<div class="line n7">7</div>
|
|
<div class="line n8">8</div>
|
|
<div class="line n9">9</div>
|
|
<div class="line n10">10</div>
|
|
<div class="line n11">11</div>
|
|
<div class="line n12">12</div>
|
|
<div class="line n13">13</div>
|
|
<div class="line n14">14</div>
|
|
<div class="line n15">15</div>
|
|
<div class="line n16">16</div>
|
|
<div class="line n17">17</div>
|
|
<div class="line n18">18</div>
|
|
<div class="line n19">19</div>
|
|
<div class="line n20">20</div>
|
|
<div class="line n21">21</div>
|
|
<div class="line n22">22</div>
|
|
<div class="line n23">23</div>
|
|
<div class="line n24">24</div>
|
|
<div class="line n25">25</div>
|
|
<div class="line n26">26</div>
|
|
<div class="line n27">27</div>
|
|
<div class="line n28">28</div>
|
|
<div class="line n29">29</div>
|
|
<div class="line n30">30</div>
|
|
<div class="line n31">31</div>
|
|
<div class="line n32">32</div>
|
|
<div class="line n33">33</div>
|
|
<div class="line n34">34</div>
|
|
<div class="line n35">35</div>
|
|
<div class="line n36">36</div>
|
|
</td>
|
|
<td class="code">
|
|
<pre><div class="container"><div class="line"><code><span class="doctype"><!doctype html></span></code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">html</span> <span class="attribute">lang</span>=<span class="value">"en"</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">head</span>></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">meta</span> <span class="attribute">charset</span>=<span class="value">"utf-8"</span>></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">title</span>></span>jQuery.uniqueSort demo<span class="tag"></<span class="title">title</span>></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">style</span>></span><span class="css"></span></code></div></div><div class="container"><div class="line"><code> <span class="tag">div</span> <span class="rules">{</span></code></div></div><div class="container"><div class="line"><code> <span class="rule"><span class="attribute">color</span>:<span class="value"> blue;</span></span></code></div></div><div class="container"><div class="line"><code> <span class="rule">}</span></code></div></div><div class="container"><div class="line"><code> <span class="tag"></<span class="title">style</span>></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">script</span> <span class="attribute">src</span>=<span class="value">"https://code.jquery.com/jquery-1.10.2.js"</span>></span><span class="javascript"></span><span class="tag"></<span class="title">script</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"></<span class="title">head</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">body</span>></span></code></div></div><div class="container"><div class="line"><code> </code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">div</span>></span>There are 6 divs in this document.<span class="tag"></<span class="title">div</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">div</span>></span><span class="tag"></<span class="title">div</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">div</span> <span class="attribute">class</span>=<span class="value">"dup"</span>></span><span class="tag"></<span class="title">div</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">div</span> <span class="attribute">class</span>=<span class="value">"dup"</span>></span><span class="tag"></<span class="title">div</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">div</span> <span class="attribute">class</span>=<span class="value">"dup"</span>></span><span class="tag"></<span class="title">div</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">div</span>></span><span class="tag"></<span class="title">div</span>></span></code></div></div><div class="container"><div class="line"><code> </code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">script</span>></span><span class="javascript"></span></code></div></div><div class="container"><div class="line"><code><span class="comment">// unique() must take a native array</span></code></div></div><div class="container"><div class="line"><code><span class="keyword">var</span> divs = $( <span class="string">"div"</span> ).get();</code></div></div><div class="container"><div class="line"><code> </code></div></div><div class="container"><div class="line"><code><span class="comment">// Add 3 elements of class dup too (they are divs)</span></code></div></div><div class="container"><div class="line"><code>divs = divs.concat( $( <span class="string">".dup"</span> ).get() );</code></div></div><div class="container"><div class="line"><code>$( <span class="string">"div:eq(1)"</span> ).text( <span class="string">"Pre-unique there are "</span> + divs.length + <span class="string">" elements."</span> );</code></div></div><div class="container"><div class="line"><code> </code></div></div><div class="container"><div class="line"><code>divs = jQuery.uniqueSort( divs );</code></div></div><div class="container"><div class="line"><code>$( <span class="string">"div:eq(2)"</span> ).text( <span class="string">"Post-unique there are "</span> + divs.length + <span class="string">" elements."</span> )</code></div></div><div class="container"><div class="line"><code> .css( <span class="string">"color"</span>, <span class="string">"red"</span> );</code></div></div><div class="container"><div class="line"><code><span class="tag"></<span class="title">script</span>></span></code></div></div><div class="container"><div class="line"><code> </code></div></div><div class="container"><div class="line"><code><span class="tag"></<span class="title">body</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"></<span class="title">html</span>></span></code></div></div></pre>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<h4>Demo:</h4>
|
|
<div class="demo code-demo"></div>
|
|
</div></section>
|
|
</div></article>
|
|
</article> |