عرض مصدر jQuery/jQuery/merge

<noinclude>{{DISPLAYTITLE:الدالة <code>‎‎jQuery.merge()‎</code>‎ في jQuery}}</noinclude>
== <code>jQuery.merge( first, second )‎</code> ==

=== القيم المعادة ===
تعيد [[JavaScript/Array|مصفوفةً]] (Array).

=== الوصف ===
تدمج هذه الدالة محتوى مصفوفتين مع بعضهما بعضًا وتضع الناتج في المصفوفة الأولى.

=== <code>jQuery.merge( first, second )‎</code> ===
أُضيفت مع الإصدار: 1.0.

==== <code>first</code> ====
الكائن الأول الشبيه بالمصفوفة المراد دمج محتواه، إذ سيضاف محتوى الوسيط الثاني إليه.

==== <code>second</code> ====
الكائن الثاني الشبيه بالمصفوفة المراد دمج محتواه، إذ سيضاف محتواه إلى الوسيط الأول.

تدمج الدالة ‎<code>$.merge()</code>‎ جميع محتويات المصفوفتين الممرَّرتين إليه في مصفوفة واحدة مع الحفاظ على ترتيب محتواهما، إذ تضاف محتويات المصفوفة الثانية إلى نهاية المصفوفة الأولى. تُعدُّ الدالة ‎$.merge()‎ مدمرة، إذ تُغيِّر قيمة الخاصِّيَّتين <code>[[CSS/length|length]]</code> والفهرس الرقمي (numeric index) للوسيط الأول المعطى من أجل إضافة عناصر إليه من الوسيط الثاني.

إن أردت الحفاظ على المصفوفة الأولى دون تعديل، فأنشئ نسخةً منها ثمَّ استعمل هذه النسخة مع الدالة <code>‎$.merge()</code>‎؛ فمن حسن الحظ أنَّه يمكن استعمال الدالة نفسها من أجل إنشاء نسخة من مصفوفة:<syntaxhighlight lang="javascript">
var newArray = $.merge([], oldArray);
</syntaxhighlight>ينشئ الاختصار <code>[]</code> مصفوفةً جديدةً فارغةً ويضع التابع محتويات المصفوفة الأصليَّة التي لا نرغب بتعديلها فيها لاستعمالها لاحقًا.

قبل الإصدار jQuery 1.4، يجب أن يُستعمَل مع هذا التابع مصفوفات حقيقيَّة (وليس كائنات شبيه بمصفوفات). إن لم يكن أحد الوسيطين أو كلاهما مصفوفةً حقيقيَّةً، فاستعمل التابع ‎<code>$.makeArray()‎</code> لتحويلهما.

=== أمثلة ===
دمج مصفوفتين في مصفوفة واحدة مع تعديل المصفوفة الأولى:<syntaxhighlight lang="javascript">
$.merge( [ 0, 1, 2 ], [ 2, 3, 4 ] )
</syntaxhighlight>ستُظهر هذه الشيفرة النتيجة التالية:<syntaxhighlight lang="text">
[ 0, 1, 2, 2, 3, 4 ]
</syntaxhighlight>دمج مصفوفتين في مصفوفة واحدة دون تعديل المصفوفة الأولى:<syntaxhighlight lang="javascript">
var first = [ "أ"‎, "ب", ‎"ت" ];
var second = [ "ث"‎, ‎"ج"‎, "ح" ];

$.merge( $.merge( [], first ), second );
</syntaxhighlight>ستُظهر هذه الشيفرة النتيجة التالية:<syntaxhighlight lang="text">
‎[ "أ"‎, "ب", ‎‎"ت"‎, "ث"‎, ‎"ج"‎, "ح" ]
</syntaxhighlight>

== مصادر ==
* [http://api.jquery.com/jQuery.merge/ صفحة الدالة ()jQuery.merge في توثيق jQuery الرسمي.]
[[تصنيف:jQuery]]
[[تصنيف:jQuery Utilities]]