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

‎.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.

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