التابع ‎‎jQuery.uniqueSort()‎‎ في jQuery

من موسوعة حسوب
< jQuery‏ | jQuery
اذهب إلى: تصفح، ابحث

jQuery.uniqueSort( array )‎

القيم المعادة

يعيد مصفوفة (Array).

الوصف

يرتِّب هذا التابع مصفوفةً من عناصر DOM، في مكانها، مع حذف العناصر المتكرِّرة. انتبه إلى أنَّ هذا التابع لا يصلح للعمل إلا مع المصفوفات التي تحوي عناصر DOM فقط.

jQuery.uniqueSort( array )‎

أُضيفت مع الإصدار: 1.12/2.2.

array

مصفوفةٌ من عناصر DOM.

يرتِّب التابع ‎$.uniqueSort()‎ مصفوفةً من الكائنات ويحذف أيَّة عقدٍ متكرِّرة. تُعدُّ العقدة متكرِّرة إن كان لها الاسم نفسه الذي تملكه عقدة أخرى موجودة قبلها في المصفوفة. أمَّا كان هنالك عقدتين مختلفتين لهما الخاصِّيَّات نفسها تمامًا، فلا تُعدُّ هاتان العقدتان حينئذِ متكرِّرتان. لا يعمل هذا التابع إلا مع مصفوفات JavaScript الصرفة التي تحوي عناصر DOM. تستعمل jQuery هذا التابع بشكل أساسي داخليًّا، ولن تحتاج على الأرجح إلى استعماله مطلقًا.

بدءًا من الإصدار jQuery 3.0، أصبح هذا التابع يدعى jQuery.unique()‎.

بدءًا من الإصدار jQuery 1.4، سترتَّب عناصر DOM وفقًا لترتيب المستند دومًا.

أمثلة

إزالة أي عناصر متكرَّرة من مصفوفة تحوي عناصر <div>:
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>jQuery.uniqueSort مثالٌ عن استعمال التابع</title>
  <style>
  div {
    color: blue;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<div>يوجد ستة عناصر من النوع div في المستند</div>
<div></div>
<div class="dup"></div>
<div class="dup"></div>
<div class="dup"></div>
<div></div>
 
<script>

var divs = $( "div" ).get();
 
// dup ذات الصنف div إضافة 3 عناصر
divs = divs.concat( $( ".dup" ).get() );
$( "div:eq(1)" ).text( "Pre-unique there are " + divs.length + " elements." );
 
divs = jQuery.uniqueSort( divs );
$( "div:eq(2)" ).text( "Post-unique there are " + divs.length + " elements." )
  .css( "color", "red" );
</script>
 
</body>
</html>

مصادر