التابع jQuery.contains() في 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