الفرق بين المراجعتين ل"jQuery/jQuery/map"
جميل-بيلوني (نقاش | مساهمات) (إضافة محتويات الصفحة.) |
جميل-بيلوني (نقاش | مساهمات) (إضافة محتويات الصفحة.) |
||
سطر 1: | سطر 1: | ||
− | <noinclude>{{DISPLAYTITLE:التابع <code>jQuery. | + | <noinclude>{{DISPLAYTITLE:التابع <code>jQuery.makeArray()</code> في jQuery}}</noinclude> |
− | == <code>jQuery. | + | == <code>jQuery.makeArray( obj )</code> == |
=== القيم المعادة === | === القيم المعادة === | ||
سطر 6: | سطر 6: | ||
=== الوصف === | === الوصف === | ||
− | + | يحوِّل هذا التابع كائنًا شبيهًا بمصفوفة إلى [[JavaScript/Array|مصفوفة JavaScript حقيقية]]. | |
− | === <code>jQuery. | + | === <code>jQuery.makeArray( obj )</code> === |
− | أُضيف مع الإصدار: 1. | + | أُضيف مع الإصدار: 1.4. |
− | ==== <code> | + | ==== <code>obj</code> ==== |
− | + | الكائن المراد تحويله إلى مصفوفة فعليَّة. | |
− | + | تعيد أغلب التوابع عمومًا، في [[jQuery]] و [[JavaScript]] كلاهما، كائنات شبيه بمصفوفة (array-like). فتعيد الدالة المنتجة <code>$()</code> مثلًا الكائن jQuery الذي يملك العديد من خاصِّيَّات المصفوفة (مثل الخاصِّيَّة <code>[[CSS/length|length]]</code>، والمعامل <code>[]</code> للوصول إلى المصفوفة ...إلخ.) إلا أنَّه ليس مصفوفة حقيقية تمامًا ويفتقد إلى بعض توابع المصفوفات المدمجة (مثل التابع <code>[[JavaScript/Array/pop|.pop()]]</code> والتابع <code>[[JavaScript/Array/reverse|.reverse()]]</code>). | |
− | |||
− | + | انتبه إلى أنَّه لم تَعد أيَّة ميزات خاصَّة يملكها الكائن (مثل توابع jQuery في مثالنا السابق) موجودةً بعد تنفيذ عملية التحويل، إذ يصبح الكائن حينئذٍ مصفوفة صرفة. | |
− | |||
− | |||
− | |||
− | الكائن | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== أمثلة === | === أمثلة === | ||
− | + | تحويل مجموعة من عناصر [[HTML]] إلى مصفوفة تحتوي على هذه العناصر:<syntaxhighlight lang="html"> | |
<!doctype html> | <!doctype html> | ||
<html lang="en"> | <html lang="en"> | ||
<head> | <head> | ||
<meta charset="utf-8"> | <meta charset="utf-8"> | ||
− | <title>jQuery. | + | <title>jQuery.makeArray مثالٌ عن استعمال التابع</title> |
<style> | <style> | ||
div { | div { | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
color: red; | color: red; | ||
} | } | ||
سطر 73: | سطر 34: | ||
<body> | <body> | ||
− | <div></div> | + | <div>واحد</div> |
− | < | + | <div>اثنان</div> |
− | < | + | <div>ثلاثة</div> |
+ | <div>أربعة</div> | ||
<script> | <script> | ||
− | var | + | // NodeList إعادة قائمة عقد |
− | + | var elems = document.getElementsByTagName( "div" ); | |
− | + | // إلى مصفوفة NodeList تحويل قائمة العقد | |
− | arr = jQuery. | + | var arr = jQuery.makeArray( elems ); |
− | + | // DOM استعمال أحد توابع المصفوفة مع قائمة عناصر | |
− | + | arr.reverse(); | |
− | + | $( arr ).appendTo( document.body ); | |
− | |||
− | |||
− | |||
− | |||
− | |||
</script> | </script> | ||
سطر 95: | سطر 52: | ||
</html> | </html> | ||
− | </syntaxhighlight> | + | </syntaxhighlight>تحويل الكائن jQuery إلى مصفوفة:<syntaxhighlight lang="javascript"> |
− | + | var obj = $( "li" ); | |
− | + | var arr = $.makeArray( obj ); | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | $ | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | var | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | </syntaxhighlight> | + | </syntaxhighlight>سنحصل عند تنفيذ هذه الشيفرة على النتيجة التالية:<syntaxhighlight lang="text"> |
− | + | ( typeof obj === "object" && obj.jquery ) === true; | |
− | + | jQuery.isArray( arr ) === true; | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
</syntaxhighlight> | </syntaxhighlight> | ||
== مصادر == | == مصادر == | ||
− | * [http://api.jquery.com/jQuery. | + | * [http://api.jquery.com/jQuery.makeArray/ صفحة التابع ()jQuery.makeArray في توثيق jQuery الرسمي.] |
[[تصنيف:jQuery]] | [[تصنيف:jQuery]] | ||
[[تصنيف:jQuery Method]] | [[تصنيف:jQuery Method]] | ||
[[تصنيف:jQuery Utilities]] | [[تصنيف:jQuery Utilities]] |
مراجعة 04:26، 1 يوليو 2018
jQuery.makeArray( obj )
القيم المعادة
يعيد مصفوفةً (Array).
الوصف
يحوِّل هذا التابع كائنًا شبيهًا بمصفوفة إلى مصفوفة JavaScript حقيقية.
jQuery.makeArray( obj )
أُضيف مع الإصدار: 1.4.
obj
الكائن المراد تحويله إلى مصفوفة فعليَّة.
تعيد أغلب التوابع عمومًا، في jQuery و JavaScript كلاهما، كائنات شبيه بمصفوفة (array-like). فتعيد الدالة المنتجة $()
مثلًا الكائن jQuery الذي يملك العديد من خاصِّيَّات المصفوفة (مثل الخاصِّيَّة length
، والمعامل []
للوصول إلى المصفوفة ...إلخ.) إلا أنَّه ليس مصفوفة حقيقية تمامًا ويفتقد إلى بعض توابع المصفوفات المدمجة (مثل التابع .pop()
والتابع .reverse()
).
انتبه إلى أنَّه لم تَعد أيَّة ميزات خاصَّة يملكها الكائن (مثل توابع jQuery في مثالنا السابق) موجودةً بعد تنفيذ عملية التحويل، إذ يصبح الكائن حينئذٍ مصفوفة صرفة.
أمثلة
تحويل مجموعة من عناصر HTML إلى مصفوفة تحتوي على هذه العناصر:
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>jQuery.makeArray مثالٌ عن استعمال التابع</title>
<style>
div {
color: red;
}
</style>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<div>واحد</div>
<div>اثنان</div>
<div>ثلاثة</div>
<div>أربعة</div>
<script>
// NodeList إعادة قائمة عقد
var elems = document.getElementsByTagName( "div" );
// إلى مصفوفة NodeList تحويل قائمة العقد
var arr = jQuery.makeArray( elems );
// DOM استعمال أحد توابع المصفوفة مع قائمة عناصر
arr.reverse();
$( arr ).appendTo( document.body );
</script>
</body>
</html>
تحويل الكائن jQuery إلى مصفوفة:
var obj = $( "li" );
var arr = $.makeArray( obj );
سنحصل عند تنفيذ هذه الشيفرة على النتيجة التالية:
( typeof obj === "object" && obj.jquery ) === true;
jQuery.isArray( arr ) === true;