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

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

jQuery.unique( array )‎

أهمل مع الإصدار: 3.0.

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

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

الوصف

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

jQuery.unique( array )‎

أُضيف مع الإصدار: 1.1.3.

array

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

بدءًا من الإصدار jQuery 3.0، أهمل هذا التابع وأصبح اسمًا بديلًا للتابع jQuery.uniqueSort()‎. استَعمِل رجاءً التابع الأخير عوضًا عن هذا التابع.

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

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

أمثلة

إزالة أي عناصر متكرِّرة من مصفوفةٍ تحوي عناصر <div>:
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>jQuery.unique مثالٌ عن استعمال التابع</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( "قبل استعمال التابع: " + divs.length + " elements." );
 
divs = jQuery.unique( divs );
$( "div:eq(2)" ).text( "بعد استعمال التابع: " + divs.length + " elements." )
  .css( "color", "red" );
</script>
 
</body>
</html>

مصادر