التابع .closest() في jQuery
.closest( selector )
القيمة المعادة
كائن jQuery.
الوصف
يُستخدَم التابع .closest() بالنسبة لكل عنصر في المجموعة للحصول على العنصر الأول الذي يُطابِق المُحدِّد عن طريق اختبار العنصر ذاته والانتقال إلى العناصر الأسلاف له في شجرة DOM.
.closest( selector )
أضيفت في الإصدار 1.3.
selector
مُحدِّد، ويُمثِّل سلسلة نصيّة تحتوي على تعبير المُحدِّد المطلوب مُطابقة العناصر معه.
.closest( selector [, context ] )
أضيفت في الإصدار: 1.4.
selector
مُحدِّد، ويُمثِّل سلسلة نصيّة تحتوي على تعبير المُحدِّد المطلوب مُطابقة العناصر معه.
context
عنصر، ويُمثِّل عنصر DOM الذي قد يُوجَد ضمنه عنصر مُطابِق.
.closest( selection )
أضيفت في الإصدار: 1.6.
selection
كائن jQuery، ويُمثِّل كائن jQuery المطلوب مُطابقة العناصر معه.
.closest( element )
أضيفت في الإصدار: 1.6.
element
عنصر، ويُمثِّل العنصر المطلوب مُطابقة العناصر معه.
بإعطاء كائن jQuery مُمثِّل لمجموعة عناصر DOM، يبحث التّابع .closest() في هذه العناصر وعناصرها الأسلاف في شجرة DOM ويبني كائن jQuery جديد من العناصر المُطابِقة. تتشابه الدالتان .parents() و .closest() في أنّ كلاهما ينتقلان للبحث في المستوى الأعلى في شجرة DOM، ومع أنّ الفوارق بينهما طفيفة ولكنّه هامة: