الفرق بين المراجعتين ل"jQuery/append"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
سطر 9: سطر 9:
 
=== <code>‎.append( content [, content ] )‎</code> ===
 
=== <code>‎.append( content [, content ] )‎</code> ===
 
أضيفت في الإصدار: 1.0.
 
أضيفت في الإصدار: 1.0.
====<code>content</code>====
+
 
 +
==== <code>content</code> ====
 
[[JavaScript/String|سلسلة نصيّة من الكائن htmlString]]، أو [[JavaScript/Element|عنصر]]، أو [[JavaScript/Text|نص]]، أو [[JavaScript/Array|مصفوفة]]، أو [[JQuery/jQuery|jQuery]]، وتُمثِّل سلسلة html، أو عنصر DOM، أو عقدة نصيّة (text node)، أو مصفوفة من العناصر والعقد النصيّة، أو كائن jQuery المطلوب إدخالها بعد كل عنصر من مجموعة العناصر المُطابقة.
 
[[JavaScript/String|سلسلة نصيّة من الكائن htmlString]]، أو [[JavaScript/Element|عنصر]]، أو [[JavaScript/Text|نص]]، أو [[JavaScript/Array|مصفوفة]]، أو [[JQuery/jQuery|jQuery]]، وتُمثِّل سلسلة html، أو عنصر DOM، أو عقدة نصيّة (text node)، أو مصفوفة من العناصر والعقد النصيّة، أو كائن jQuery المطلوب إدخالها بعد كل عنصر من مجموعة العناصر المُطابقة.
 
====<code>content</code>====
 
====<code>content</code>====
سطر 19: سطر 20:
 
==== <code>function</code> ====
 
==== <code>function</code> ====
 
دالة على الشكل <code>[[JavaScript/Function|Function]]( [[JavaScript/Integer|Integer]] index, [[JavaScript/String|String]] html )‎</code> تُعيد [[JavaScript/String|سلسلة نصيّة من الكائن htmlString]]، أو [[JavaScript/Element|عنصر أو عناصر DOM]]، أو عقدة أو عقد نصيّة، أو كائن jQuery المطلوب إدخالها بعد كل عنصر من مجموعة العناصر المُطابقة. يُمثِّل المعاملُ <code>[[JavaScript/this|this]]</code> العنصرَ الحالي. تستقبل فهرس موقع العنصر في المجموعة وقيمة html القديمة للعنصر كوسائط لها.
 
دالة على الشكل <code>[[JavaScript/Function|Function]]( [[JavaScript/Integer|Integer]] index, [[JavaScript/String|String]] html )‎</code> تُعيد [[JavaScript/String|سلسلة نصيّة من الكائن htmlString]]، أو [[JavaScript/Element|عنصر أو عناصر DOM]]، أو عقدة أو عقد نصيّة، أو كائن jQuery المطلوب إدخالها بعد كل عنصر من مجموعة العناصر المُطابقة. يُمثِّل المعاملُ <code>[[JavaScript/this|this]]</code> العنصرَ الحالي. تستقبل فهرس موقع العنصر في المجموعة وقيمة html القديمة للعنصر كوسائط لها.
 +
 +
يُدخِل التّابع <code>‎.append()‎</code> المحتوى المُحدَّد كآخر ابن (last child) لكل عنصر من مجموعة jQuery (لإدخاله كأول ابن استخدم التّابع <code>[[jQuery/prepend|‎.prepend()]]</code>‎).
 +
 +
ينجز التّابعان ‎<code>.append()</code>‎ و <code>‎[[jQuery/appendTo|.appendTo()]]‎</code> نفس المهمة ويكمن الفرق الأساسي بينهما في الصّياغة، أي في مكان تحديد المحتوى والعناصر الهدف، فبالنسبة للتابع <code>‎.append()‎</code>

مراجعة 14:24، 13 مايو 2018

‎.append( content [, content ] )‎

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

كائن jQuery.

الوصف

يُستخدَم التّابع ‎.append()‎ في إدخال المحتوى المُحدَّد عن طريق المُعامِل إلى آخر كل عنصر من مجموعة العناصر المُطابِقة.

‎.append( content [, content ] )‎

أضيفت في الإصدار: 1.0.

content

سلسلة نصيّة من الكائن htmlString، أو عنصر، أو نص، أو مصفوفة، أو jQuery، وتُمثِّل سلسلة html، أو عنصر DOM، أو عقدة نصيّة (text node)، أو مصفوفة من العناصر والعقد النصيّة، أو كائن jQuery المطلوب إدخالها بعد كل عنصر من مجموعة العناصر المُطابقة.

content

سلسلة نصيّة من الكائن htmlString، أو عنصر، أو نص، أو مصفوفة، أو jQuery، وتُمثِّل عنصرًا إضافيًا واحدًا أو أكثر من عناصر DOM، أو العقد النصيّة (text node)، أو مصفوفات من العناصر والعقد النصية، أو سلسلة html، أو كائنات jQuery المطلوب إدخالها بعد كل عنصر من مجموعة العناصر المُطابقة.

‎.append( function )‎

أضيفت في الإصدار: 1.4.

function

دالة على الشكل Function( Integer index, String html )‎ تُعيد سلسلة نصيّة من الكائن htmlString، أو عنصر أو عناصر DOM، أو عقدة أو عقد نصيّة، أو كائن jQuery المطلوب إدخالها بعد كل عنصر من مجموعة العناصر المُطابقة. يُمثِّل المعاملُ this العنصرَ الحالي. تستقبل فهرس موقع العنصر في المجموعة وقيمة html القديمة للعنصر كوسائط لها.

يُدخِل التّابع ‎.append()‎ المحتوى المُحدَّد كآخر ابن (last child) لكل عنصر من مجموعة jQuery (لإدخاله كأول ابن استخدم التّابع ‎.prepend()‎).

ينجز التّابعان ‎.append()‎ و ‎.appendTo() نفس المهمة ويكمن الفرق الأساسي بينهما في الصّياغة، أي في مكان تحديد المحتوى والعناصر الهدف، فبالنسبة للتابع ‎.append()‎