الفرق بين المراجعتين ل"jQuery/closest"
Kinan-mawed (نقاش | مساهمات) |
Kinan-mawed (نقاش | مساهمات) |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>.closest()</code> في jQuery}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>.closest()</code> في jQuery}}</noinclude> | ||
| + | |||
==<code>.closest( selector )</code>== | ==<code>.closest( selector )</code>== | ||
===القيمة المعادة=== | ===القيمة المعادة=== | ||
| سطر 17: | سطر 18: | ||
===<code>.closest( selection )</code>=== | ===<code>.closest( selection )</code>=== | ||
أضيفت في الإصدار: 1.6. | أضيفت في الإصدار: 1.6. | ||
| − | + | ====<code>selection</code>==== | |
| − | ==== <code>selection</code> ==== | ||
كائن [[JQuery/jQuery|jQuery]]، ويُمثِّل كائن jQuery المطلوب مُطابقة العناصر معه. | كائن [[JQuery/jQuery|jQuery]]، ويُمثِّل كائن jQuery المطلوب مُطابقة العناصر معه. | ||
| − | + | ===<code>.closest( element )</code>=== | |
| − | === <code>.closest( element )</code> === | ||
أضيفت في الإصدار: 1.6. | أضيفت في الإصدار: 1.6. | ||
| − | + | ====<code>element</code>==== | |
| − | ==== <code>element</code> ==== | ||
[[JavaScript/Element|عنصر]]، ويُمثِّل العنصر المطلوب مُطابقة العناصر معه. | [[JavaScript/Element|عنصر]]، ويُمثِّل العنصر المطلوب مُطابقة العناصر معه. | ||
| − | بإعطاء كائن jQuery مُمثِّل لمجموعة عناصر DOM، يبحث التّابع <code>.closest()</code> في هذه العناصر وعناصرها الأسلاف في شجرة DOM ويبني كائن jQuery جديد من العناصر المُطابِقة. تتشابه الدالتان <code>[[ | + | بإعطاء كائن jQuery مُمثِّل لمجموعة عناصر DOM، يبحث التّابع <code>.closest()</code> في هذه العناصر وعناصرها الأسلاف في شجرة DOM ويبني كائن jQuery جديد من العناصر المُطابِقة. تتشابه الدالتان <code>[[JQuery/parents|.parents()]]</code> و <code>.closest()</code> في أنّ كلاهما ينتقلان للبحث في المستوى الأعلى في شجرة DOM، ومع أنّ الفوارق بينهما طفيفة ولكنّها هامة: |
| − | |||
{| class="wikitable" | {| class="wikitable" | ||
| − | |||
!<code>.closest()</code> | !<code>.closest()</code> | ||
| + | !<code>[[JQuery/parents|.parents()]]</code> | ||
|- | |- | ||
| − | | | + | |تبدأ بالعنصر الحالي. |
| − | | | + | |تبدأ بالعنصر الأب. |
|- | |- | ||
| − | | | + | |تنتقل إلى المستويات الأعلى في شجرة DOM حتى تجد مُطابقًا للمُحدِّد المطلوب. |
| − | | | + | |تنتقل |
|- | |- | ||
| | | | ||
| | | | ||
|} | |} | ||
مراجعة 09:03، 28 مايو 2018
.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، ومع أنّ الفوارق بينهما طفيفة ولكنّها هامة:
.closest()
|
.parents()
|
|---|---|
| تبدأ بالعنصر الحالي. | تبدأ بالعنصر الأب. |
| تنتقل إلى المستويات الأعلى في شجرة DOM حتى تجد مُطابقًا للمُحدِّد المطلوب. | تنتقل |