روش مرور jQuery - nextUntil()

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

مثال

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

$("#term-2").nextUntil("dt").css("background-color", "red");
var term3 = document.getElementById("term-3");
$("#term-1").nextUntil(term3, "dd").css("color", "blue");

آزمایش شخصی

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

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

گزارش 1

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

گزارش 2

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

توضیحات

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

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

برای jQuery 1.6، می‌توان یک گره DOM یا یک شیء jQuery را به جای انتخابگر به روش .nextUntil() ارسال کرد.

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

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