الفرق بين المراجعتين لصفحة: «jQuery/addClass»

التعديل اللاحق ←

مرئينص الويكي

مراجعة 11:20، 4 مايو 2018

`‎.addClass( className )‎`

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

كائن jQuery.

الوصف

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

`‎.addClass( className )‎`

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

`className`

سلسلة نصيّة من الكائن String، وتُمثِّل صنف أو عدة أصناف مفصولة بمسافة بينها لإضافتها إلى الخاصيّة class لكل عنصر مُطابق.

`‎.addClass( function )‎`

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

`Function`

دالة على الشكل Function( Integer index, String currentClassName )‎ وتُعيد سلسلة نصيّة.

دالة تُعيد اسم أو عدة أسماء لأصناف مفصولةً بمسافة بينها لإضافتها إلى اسم الصّنف أو أسماء الأصناف الموجودة. this هو العنصر الحالي. تستقبل فهرس موقع العنصر في المجموعة واسم أو أسماء الأصناف الموجودة كوسائط لها.

من المهم أن نلاحظ أن هذا التّابع لا يستبدل الصّنف الحالي، بل يضيفه ببساطة ملحقًا إياه بأي صنف معين مسبقًا للعناصر.

قبل إصدار jQuery 1.2/2.2 كان التّابع ‎.addClass()‎ يتحكم بخاصيّة الكائن className للعناصر المحدّدة وليس بخاصيّة HTML ‏class‏، وحالما تتغيّر خاصيّة الكائن يُحدِّث المتصفّح خاصيّة HTML وفق ذلك، وتفسير هذا السّلوك هو أنّ هذا التّابع كان يعمل فقط للمستندات ذات الصّياغة HTML DOM (على سبيل المثال مستندات XML غير النقيّة).

تغيّر هذا السّلوك بدءًا من إصدار jQuery 1.12/2.2 لتحسين الدّعم لمستندات XML وتضمين مستندات SVG أيضًا. وبدءًا من هذا الإصدار استُخدِمَت خاصيّة HTML ‏class بدلًا من ذلك، لذا يُمكِن استخدام التّابع ‎.addClass()‎ مع مستندات XML أو SVG.

من الممكن إضافة أكثر من صنف في نفس الوقت، مفصولةً بمسافة بينها، إلى مجموعة العناصر المُطابقة كما يلي:

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE:التابع <code>‎‎.addClass()‎‎</code>‎ في jQuery}}</noinclude>
+== <code>‎.addClass( className )‎</code> ==
+=== القيمة المعادة ===
+كائن [[jQuery/jQuery|jQuery]].
+=== الوصف ===
+يُستخدَم التّابع <code>‎.addClass()‎</code> لإضافة الصّنف أو الأصناف المُحدَّدة لكل عنصر من مجموعة العناصر المُطابقة.
+=== <code>‎.addClass( className )‎</code> ===
+أضيفت في الإصدار: 1.0
+==== <code>className</code> ====
+سلسلة نصيّة من الكائن <code>[[JavaScript/String|String]]</code>، وتُمثِّل صنف أو عدة أصناف مفصولة بمسافة بينها لإضافتها إلى الخاصيّة <code>class</code> لكل عنصر مُطابق.
+=== <code>‎.addClass( function )‎</code> ===
+أضيفت في الإصدار: 1.4
+==== <code>Function</code> ====
+دالة على الشكل <code>[[JavaScript/Function|Function]]( [[JavaScript/Integer|Integer]] index, [[JavaScript/String|String]] currentClassName )‎</code> وتُعيد [[JavaScript/String|سلسلة نصيّة]].
+دالة تُعيد اسم أو عدة أسماء لأصناف مفصولةً بمسافة بينها لإضافتها إلى اسم الصّنف أو أسماء الأصناف الموجودة. <code>this</code> هو العنصر الحالي. تستقبل فهرس موقع العنصر في المجموعة واسم أو أسماء الأصناف الموجودة كوسائط لها.
+من المهم أن نلاحظ أن هذا التّابع لا يستبدل الصّنف الحالي، بل يضيفه ببساطة ملحقًا إياه بأي صنف معين مسبقًا للعناصر.
+قبل إصدار jQuery 1.2/2.2 كان التّابع ‎<code>.addClass()</code>‎ يتحكم بخاصيّة الكائن <code>className</code> للعناصر المحدّدة وليس بخاصيّة HTML <code>‏class</code>‏، وحالما تتغيّر خاصيّة الكائن يُحدِّث المتصفّح خاصيّة HTML وفق ذلك، وتفسير هذا السّلوك هو أنّ هذا التّابع كان يعمل فقط للمستندات ذات الصّياغة HTML DOM (على سبيل المثال مستندات XML غير النقيّة).
+تغيّر هذا السّلوك بدءًا من إصدار jQuery 1.12/2.2 لتحسين الدّعم لمستندات XML وتضمين مستندات SVG أيضًا. وبدءًا من هذا الإصدار استُخدِمَت خاصيّة HTML <code>‏class</code> بدلًا من ذلك، لذا يُمكِن استخدام التّابع <code>‎.addClass()</code>‎ مع مستندات XML أو SVG.
+من الممكن إضافة أكثر من صنف في نفس الوقت، مفصولةً بمسافة بينها، إلى مجموعة العناصر المُطابقة كما يلي: