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

`‎.toArray()‎`

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

يعيد مصفوفة من النوع Array.

الوصف

يضع هذا التابع جميع العناصر الموجودة في مجموعة jQuery في مصفوفة ثمَّ يعيدها.

`‎.toArray()‎`

أُضيف مع الإصدار: 1.4. ولا يقبل هذا التابع أية وسائط.

يضع هذا التابع جميع العناصر الموجودة في مجموعة jQuery في مصفوفة ثم يعيدها:

alert( $( "li" ).toArray() );

ستُعاد جميع عقد DOM المطابقة عند استدعاء هذا السطر في مصفوفة قياسية:

[<li id="foo">, <li id="bar">]

أمثلة

تحديد جميع العناصر <div> في الصفحة ثمَّ إعادة العناصر DOM في مصفوفة ثمَّ استعمال التابع reverse()‎ المضمَّن في الكائن Array لعكس ترتيب قيم تلك المصفوفة:

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>toArray مثالٌ عن استعمال التابع</title>
  <style>
  span {
    color: red;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
القيم معكوسة - <span></span>
 
<div>واحد</div>
<div>اثنان</div>
<div>ثلاثة</div>
 
<script>
function disp( divs ) {
  var a = [];
  for ( var i = 0; i < divs.length; i++ ) {
    a.push( divs[ i ].innerHTML );
  }
  $( "span" ).text( a.join( " " ) );
}
 
disp( $( "div" ).toArray().reverse() );
</script>
 
</body>
</html>

مصادر

صفحة التابع ‎‎.toArray()‎ في توثيق jQuery الرسمي.