jQuery مرور - روش prevUntil()
مثال
جستجو کنید تا همه عناصر p که همسایههای آنها دارای نام کلاس "selected" هستند را پیدا کنید:
$("p").siblings(".selected")
تعریف و استفاده
siblings() عناصر همسایه هر عنصر در مجموعه تطابقیافته را دریافت میکند، فیلتر کردن با انتخابگر انتخابی است.
زبان
.siblings(selector)
پارامتر | توضیح |
---|---|
selector | مقدار رشتهای که شامل انتخابگر رشتهای برای تطابق عناصر است. |
توضیحات دقیق
اگر یک شیء jQuery نشاندهنده مجموعهای از عناصر DOM داده شود، روش .siblings() به ما اجازه میدهد تا در درخت DOM عناصر همسایه این عناصر را جستجو کنیم و یک شیء jQuery جدید از عناصر تطابقیافته بسازیم.
این روش یک انتخابگر انتخابی پذیر میپذیرد، که نوعی از پارامترهایی است که به $() فراوانی میدهیم. اگر این انتخابگر اعمال شود، عناصر با بررسی اینکه آیا با این انتخابگر مطابقت دارند یا خیر، فیلتر میشوند.
به این صفحه با لیستهای پیچیده ابتدایی فکر کنید:
<ul> <li>لیست آیتم 1</li> <li>لیست آیتم 2</li> <li class="third-item">لیست آیتم 3</li> <li>لیست آیتم 4</li> <li>لیست آیتم 5</li> </ul>
اگر از سومین آیتم شروع کنیم، میتوانیم عناصر همسایه این عنصر را پیدا کنیم:
$('li.third-item').siblings().css('background-color', 'red');
نتیجهای که در اینجا فراخوانی میشود، این است که پس زمینه پروژههای 1، 2، 4 و 5 به قرمز تنظیم شود. پس زمینه قرمز تنظیم شود. به دلیل اینکه ما انتخابگر را اعمال نکردهایم، همه عناصر همسایه به طور طبیعی بخشی از این آیتمها هستند. اگر انتخابگر اعمال شده باشد، فقط آیتمهای تطابقیافته در چهار لیست شامل خواهند شد.
عناصر اولیه شامل عناصر همسایه نمیشوند، زمانی که قصد داریم همه عناصر در لایه خاصی از درخت DOM را پیدا کنیم، این نکته مهمی است که باید به خاطر بسپاریم.