مетод closest() HTML DOM Element

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

closest() این روش در درخت DOM به دنبال عنصری می‌گردد که با انتخابگر CSS مشخص شده مطابقت دارد.

closest() این روش از عنصر خود شروع می‌کند، سپس از اجداد (پدر، اجداد، ...) و تا زمانی که تطابق پیدا کند ادامه می‌دهد.

اگر هیچ تطابق‌ی پیدا نشود، closest() این روش بازمی‌گرداند null.

لطفاً به: مراجعه کنید

دستورالعمل کامل CSS انتخابگر

مетод Element matches()

مثال

مثال 1

پیدا کردن نزدیک‌ترین عنصری که با انتخابگر CSS ".container" مطابقت دارد:

const element = document.getElementById("myElement");
const closest = element.closest(".container");

آزمایش کنید

مثال 2

پیدا کردن نزدیک‌ترین عنصری که با ".container" یا ".wrapper" مطابقت دارد:

const element = document.getElementById(".container, .wrapper");
const closest = element.closest(".container");

آزمایش کنید

قانون‌نویسی

element.closest(selectors)

پارامتر

پارامتر توضیح
selectors

ضروری. یک یا چند (با کاما جدا شده) انتخابگر CSS که باید تطابق داشته باشند.

لطفاً به دستورالعمل‌های کامل ما دستورالعمل انتخابگر CSS.

مقدار بازگشتی

نوع توضیح
عنصر

عنصر نزدیک‌ترین که با انتخابگر CSS مشخص شده مطابقت دارد یا خود عنصر.

اگر هیچ تطابق‌ی پیدا نشود، null برمی‌گرداند.

اگر انتخابگر معتبر نباشد، خطای SYNTAX_ERR ایجاد می‌شود.

پشتیبانی مرورگر

اولین مرورگر کامل closest() نسخه مرورگر روش:

کروم ایج فایرفاکس سفاری اپرا
کروم
41		 ایج
15		 فایرفاکس
35		 سفاری
9		 اپرا
28
مارس 2015 آوریل 2017 ژانویه 2015 مهر 2015 مارس 2015