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

من موسوعة حسوب
< jQuery‏ | jQuery
اذهب إلى: تصفح، ابحث

jQuery.contains( container, contained )‎

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

يعيد قيمة منطقيَّة (Boolean).

الوصف

يتحقَّق هذا التابع إن كان عنصر DOM معيَّن هو عنصر سليل (ancestor) من عنصر DOM آخر.

jQuery.contains( container, contained )‎

أُضيف مع الإصدار: 1.4.

container

عنصر DOM الذي قد يحوي العنصر contained المعطى.

contained

العنصر DOM الذي سيتأكد التابع من أنَّه عنصرٌ سليلٌ من العنصر container.

يعيد التابع ‎$.contains()‎ القيمة true إن كان العنصر contained المعطى هو عنصر سليل من العنصر container المعطى أيضًا سواءً كان ذلك العنصر ابنًا مباشرًا أو كان حفيدًا متشعبًا بعمق. خلا ذلك، سيعيد التابع القيمة false.

انتبه إلى أنَّ العناصر العقد (element nodes) مدعومةٌ فقط؛ فإن كان الوسيط الثاني هو عقدة نصيَّة (text node) أو عقدة تعليق (comment node)، فسيعيد التابع القيمة false.

ملاحظة: يجب أن يكون العنصر الأول عنصر DOM وليس كائن jQuery أو كائن JavaScript مجرَّد.

أمثلة

التحقق إن كان عنصرٌ ما سليلًا من عنصر آخر:
$.contains( document.documentElement, document.body ); // true
$.contains( document.body, document.documentElement ); // false

مصادر