jQuery پیمانندگی - روش prevUntil()

jQuery پیمانندگی مرجع

مثال

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

$("#term-2").prevUntil("dt").css("رنگ پس‌زمینه", "قرمز");
var term1 = document.getElementById('term-1');
$("#term-3").prevUntil(term1, "dd").css("رنگ", "سبز");

آزمایش شخصی

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

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

نوع گرامر 1

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

نوع گرامر 2

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

شرح کامل

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

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

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

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

jQuery پیمانندگی مرجع