روش parentsUntil() مرور jQuery

دستورالعمل مرور jQuery

مثال

جستجو برای اجداد <li class="item-a"> تا <ul class="level-1"> و آن‌ها را به رنگ پس‌زمینه‌ی قرمز تنظیم می‌کند. همچنین، تمام اجداد با نام کلاس "yes" برای <li class="item-2"> تا <ul class="level-1"> پیدا می‌کند و برای آن‌ها پارتیشن‌های آبی را تنظیم می‌کند:

$("li.item-a");.parentsUntil(".level-1");
  .css("background-color", "red");
$("li.item-2");.parentsUntil($("ul.level-1"), ".yes");
  .css("border", "3px solid blue");

آزمایش شخصی

تعریف و استفاده

parentsUntil() اجداد هر عنصر در مجموعه‌ی تطابق فعلی را تا زمانی که (اما بدون) عنصری که با انتخابگر، نقطه‌ی DOM یا شیء jQuery تطابق دارد، می‌یابد، به دست می‌آورد.

جملات 1

.parentsUntil(انتخابگر,فیلتر)
پارامترها توضیح
انتخابگر اختیاری. یک رشته‌ی متنی که نشان‌دهنده‌ی مکانی است که باید به آن مرور اجداد متوقف شود.
فیلتر اختیاری. یک رشته‌ی متنی که شامل انتخابگر رشته‌ای برای تطابق با عناصر است.

جملات 2

.parentsUntil(عنصر,فیلتر)
پارامترها توضیح
عنصر اختیاری. یک نقطه‌ی DOM یا شیء jQuery که نشان‌دهنده‌ی مکانی است که باید به آن مرور اجداد متوقف شود.
فیلتر اختیاری. یک رشته‌ی متنی که شامل انتخابگر رشته‌ای برای تطابق با عناصر است.

توضیحات دقیق

اگر یک شیء jQuery که مجموعه‌ای از عناصر DOM را نشان می‌دهد، به عنوان پارامتر داده شود، روش .parentsUntil() به ما اجازه می‌دهد تا در درخت DOM به دنبال اجداد این عناصر بگردیم تا به عنصری برسیم که با انتخابگر (پارامتری که به روش داده می‌شود) تطابق دارد. شیء jQuery بازگشتی شامل تمام اجداد است، اما عناصری که با روش .parentsUntil() تطابق دارند، شامل نمی‌شود.

اگر تطابق نداشته باشد یا پارامتر اعمال نشده باشد، تمام عناصر اجداد انتخاب شده را انتخاب می‌کند؛ در این حالت، عناصر انتخاب شده توسط این روش با روش .parents() که هیچ انتخابگری ارائه نشده است، مشابه است.

برای jQuery 1.6، می‌توان نقطه‌ی DOM یا شیء jQuery را به جای انتخابگر به عنوان اولین پارامتر روش .parentsUntil() استفاده کرد.

این روش پارامتر انتخابگر انتخابی را به عنوان دومین پارامتر خود می‌پذیرد. اگر این پارامتر را اعمال کنید، عناصر را بر اساس تطابق با این انتخابگر فیلتر می‌کند.

دستورالعمل مرور jQuery