التابع `‎.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، ومع أنّ الفوارق بينهما طفيفة ولكنّها هامة:

`‎.parents()‎`	`‎.closest()‎`