روش prevUntil() مرور jQuery

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

مثال

پیدا کردن عناصر همسایه‌ی پیشین <dt id="term-2"> تا <dt> قبلی، و آن‌ها را به رنگ قرمز تنظیم کنید. همچنین، پیدا کردن عناصر همسایه‌ی پیشین <dd> تا <dt id="term-1"> و آن‌ها را به رنگ نوشتاری آبی تنظیم کنید:

$("#term-2").prevUntil("dt").css("background-color", "red");
var term1 = document.getElementById('term-1');
$("#term-3").prevUntil(term1, "dd").css("color", "green");

آزمایش شخصی کنید

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

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

قانون 1

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

قانون 2

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

توضیحات دقیق‌تر

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

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

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

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

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