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

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

مثال

با اضافه کردن یک کلاس مناسب به div با index 2، آن را به رنگ آبی در می‌آوریم:

$("body").find("div").eq(2).addClass("blue");

آزمایش کنید

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

روش eq() مجموعه عناصر تطبیقی را به عنصر مشخص شده توسط index محدود می‌کند.

قانون‌نویسی

.eq(index)
پارامتر توضیح
index

عدد صحیح، نشان‌دهنده موقعیت عنصر (کمینه 0).

اگر عدد منفی باشد، از آخرین عنصر در مجموعه به عقب شمارش می‌شود.

شرح

اگر جعبه jQuery نشان‌دهنده مجموعه‌ای از عناصر DOM داده شود، روش .eq() یک جعبه jQuery جدید با استفاده از یک عنصر از مجموعه ایجاد می‌کند. پارامتر index نشان‌دهنده موقعیت عنصر در مجموعه است.

لطفاً به لیست ساده زیر نگاه کنید:

<ul>
  <li>آیتم لیست 1</li>
  <li>آیتم لیست 2</li>
  <li>آیتم لیست 3</li>
  <li>آیتم لیست 4</li>
  <li>آیتم لیست 5</li>
</ul>

مثال 1

ما می‌توانیم این روش را به مجموعه آیتم‌های لیست اعمال کنیم:

$('li').eq(2).css('background-color', 'red');

آزمایش کنید

نتیجه این فراخوانی برای تنظیم پس‌زمینه آیتم 3 به رنگ قرمز است. توجه داشته باشید که index بر اساس صفر است و در جعبه jQuery به موقعیت عناصر اشاره می‌کند، نه در درخت DOM.

مثال 2

اگر عدد منفی ارائه شود، این نشان‌دهنده موقعیت از انتهای مجموعه است، نه از ابتدا. به عنوان مثال:

$('li').eq(-2).css('background-color', 'red');

آزمایش کنید

این بار، پس‌زمینه آیتم 4 به رنگ قرمز در می‌آید، زیرا او دومین آیتم از انتهای مجموعه است.

مثال 3

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

$('li').eq(5).css('background-color', 'red');

آزمایش کنید

در اینجا، هیچ لیست‌ای به رنگ قرمز در نمی‌آید، زیرا آیتم ششم به وسیله .eq(5) اشاره شده است.

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