متد ()closest در jQuery
مثال (متد ()closest در jQuery)
اولین جد تگ <span>، که یک تگ <ul> است، را بر می گرداند:
$("span").closest("ul").css({"color": "red", "border": "2px solid red"});
});
خودتان امتحان کنید »
تعریف و کاربرد
متد ()closest، اولین جدِ عنصر انتخابی را بر می گرداند.
جد، یک پدر، پدربزرگ، پدرِ پدر بزرگ، و به این ترتیب است..
درخت DOM: این متد پیمایش روبه بالا یِ درخت DOM را تا رسیدن به عنصر ریشه (<html>)، برای یافتن اولین جد عنصر DOM انجام می دهد.
این متد مشابه متد ()parents است، که در هردویِ آنها درخت DOM رو به بالا پیمایش می شود، تفاوت آنها به شرح زیر است:
()closest
- با عنصر فعلی شروع می شود.
- پیمایش درخت DOM به سمت بالا و برگرداندن اولین (تنها)، جد عنصر انتخابی، که متناسب با معیارهای خواسته شده باشد.
- شی جی کوئریِ بازگشتی حاوی مقدار صفر یا یک عنصر است.
()parents
- از عنصر پدر شروع می شود.
- یمایش درخت DOM به سمت بالا و برگرداندن تمامیِ اجدادِ عنصر انتخابی، که متناسب با معیارهای خواسته شده باشد
- شی جی کوئریِ بازگشتی حاوی مقدار صفر یا بیش از یک عنصر است.
متدهای مشابه دیگر:
- ()parent - پدرِ مستقیم عنصر انتخابی را بر می گرداند.
- ()parentsUntil - تمامیِ اجداد عنصر انتخابی، بین دو پارامتر داده شده را بر می گرداند.
نحوه استفاده
اولین جد عنصر انتخابی را بر می گرداند:
برگرداندن اولین جد با استفاده از یک متن DOM برایِ مشاهده درخت DOM :
پارامتر | توضیحات |
---|---|
filter | اجباری است. یک عبارت انتخابی، عنصر یا شی جی کوئری، برای محدود سازی جستجوی اجداد یک عنصر. |
context | اختیاری است. یک عنصر DOM است که با عنصری که ممکن است یافت شود تطبیق داده می شود. |
مثال های خودتان امتحان کنید
اولین جد تگ <span> که یک تگ <span> هست را بر می گرداند
از آنجایی که این متد با عنصر فعلی شروع می شود. یک جستجو برای اولین تگ <span>، همان تگ <span> را بر می گرداند.
انتخاب یک مجموعه از عناصر DOM، که جستجو برای اولین جد در آن صورت می گیرد
استفاده از هر دو پارامتر برای جستجوی اولین تگ <ul>، در یک مجموعه از عناصر DOM.
مرجع متدهای پیمایش عناصر در jQuery
- نوشته شده توسط شهربانو دوستی
- بازدید: 8434