سبد (0)

متد ()closest در jQuery

مثال (متد ()closest در jQuery)

اولین جد تگ <span>، که یک تگ <ul> است، را بر می گرداند:

$(document).ready(function(){
    $("span").closest("ul").css({"color": "red", "border": "2px solid red"});
});

خودتان امتحان کنید »

تعریف و کاربرد

متد ()closest، اولین جدِ عنصر انتخابی را بر می گرداند.

جد، یک پدر، پدربزرگ، پدرِ پدر بزرگ، و به این ترتیب است..

درخت  DOM: این متد پیمایش روبه بالا یِ درخت DOM را تا رسیدن به عنصر ریشه (<html>)، برای یافتن اولین جد عنصر DOM انجام می دهد.

  این متد مشابه متد ()parents است، که در هردویِ آنها درخت DOM رو به بالا پیمایش می شود، تفاوت آنها به شرح زیر است:

()closest

  • با عنصر فعلی شروع می شود.
  • پیمایش درخت DOM به سمت بالا و برگرداندن اولین (تنها)، جد عنصر انتخابی، که متناسب با معیارهای خواسته شده باشد.
  • شی جی کوئریِ بازگشتی حاوی مقدار صفر یا یک عنصر است.

()parents

  • از عنصر پدر شروع می شود.
  • یمایش درخت DOM به سمت بالا و برگرداندن تمامیِ اجدادِ عنصر انتخابی، که متناسب با معیارهای خواسته شده باشد
  • شی جی کوئریِ بازگشتی حاوی مقدار صفر یا بیش از یک عنصر است.

متدهای مشابه دیگر:

  • ()parent - پدرِ مستقیم عنصر انتخابی را بر می گرداند.
  • ()parentsUntil - تمامیِ اجداد عنصر انتخابی، بین دو پارامتر داده شده را بر می گرداند.

نحوه استفاده

اولین جد عنصر انتخابی را بر می گرداند:

$(selector).closest(filter)

برگرداندن اولین جد با استفاده از یک متن DOM برایِ مشاهده درخت DOM :

$(selector).closest(filter,context)
پارامترتوضیحات
filter اجباری است. یک عبارت انتخابی، عنصر یا شی جی کوئری، برای محدود سازی جستجوی اجداد یک عنصر.
context اختیاری است. یک عنصر DOM است که با عنصری که ممکن است یافت شود تطبیق داده می شود.
مثالs

مثال های خودتان امتحان کنید

اولین جد تگ <span> که یک تگ <span> هست را بر می گرداند
 از آنجایی که این متد با عنصر فعلی شروع می شود. یک جستجو برای اولین تگ <span>، همان تگ <span> را بر می گرداند.

 انتخاب یک مجموعه از عناصر DOM، که جستجو برای اولین جد در آن صورت می گیرد 

استفاده از هر دو پارامتر برای جستجوی اولین تگ <ul>، در یک مجموعه از عناصر DOM. 


jQuery HTML Methodsمرجع متدهای پیمایش عناصر در jQuery

تمامی محصولات و خدمات این وبسایت، حسب مورد دارای مجوزهای لازم از مراجع مربوطه می‌باشند و فعالیت‌های این سایت تابع قوانین و مقررات جمهوری اسلامی ایران است.
logo-samandehi مجوز نشر دیجیتال از وزرات فرهنگ و ارشاد اسلامی پرداخت آنلاین -  بانک ملت معرفی بیاموز در شبکه سه