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

‎.contents()‎

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

كائن jQuery.

الوصف

يُستخدَم التابع ‎.contents()‎ للحصول على العناصر الأبناء لكل عنصر من مجموعة العناصر المُطابِقة، بما في ذلك عقد النصوص والتعليقات.

‎.contents()‎

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

لا يقبل هذا التّابع أي وسائط.

يسمح لنا التّابع ‎‎.contents()‎‎، من خلال إعطاء كائن jQuery يُمثِّل مجموعة عناصر DOM، أن نبحث خلال العناصر الأبناء المباشرين لها في شجرة DOM وأن نبني كائن jQuery جديد من العناصر المُطابِقة. إنّ التابعين ‎.contents()‎ و ‎.children()‎ متشابهان فيما عدا أنّ التّابع ‎.contents()‎ يُضمِّن العقد النصيّة وعقد التعليقات بالإضافة إلى عناصر HTML في كائن jQuery الناتج. لاحظ أنّ معظم العمليّات في jQuery لا تدعم العقد النصيّة وعقد التعليقات، والقليل منها التي تدعم ذلك تحتوي على ملاحظة واضحة مذكورة في صفحة التوثيق الخاصّة بها.

يُمكِن استخدام التّابع ‎.contents()‎ أيضًا في الحصول على محتوى المستند لعنصر الإطار <iframe‎> إن كان هذا العنصر يُشير إلى نفس المجال (domain) للصفحة الرئيسيّة.

فلنأخذ مثال عن عنصر <div‎> ي