مетод compareDocumentPosition() DOM Element HTML
- صفحه قبلی closest()
- صفحه بعدی contains()
- برگشت به طبقه بالاتر موضوع Elements DOM HTML
تعریف و کاربرد
compareDocumentPosition() این روش دو نود را مقایسه می‌کند و یک عدد برمی‌گرداند که موقعیت آن‌ها در سند را توضیح می‌دهد:
| مقدار | معنی |
|---|---|
| 1 | نودها به یک سند مشترک تعلق ندارند. |
| 2 | نود اول پس از نود دوم قرار دارد. |
| 4 | نود اول قبل از نود دوم قرار دارد. |
| 8 | نود اول در داخل نود دوم قرار دارد. |
| 16 | نود دوم در داخل نود اول قرار دارد. |
| 32 | نود یک ویژگی است که در یک عنصر قرار دارد. |
نکات
مقدار بازگشتی می‌تواند ترکیبی از مقدارها باشد.
مقدار 20 نشان‌دهنده این است که نود دوم در داخل نود اول (16) قرار دارد و نود اول قبل از نود دوم قرار دارد (4).
مثال
"p1" در مقایسه با "p2" کجا قرار دارد:
const p1 = document.getElementById("p1");
const p2 = document.getElementById("p2");
let position = p1.compareDocumentPosition(p2);
نحوه‌ی استفاده
node.compareDocumentPosition(node)
پارامتر
| پارامتر | توضیح |
|---|---|
| Node | ضروری. نود باید با آن مقایسه شود. |
مقدار بازگشتی
| نوع | توضیح |
|---|---|
| عدد | موقعیت مقایسه‌ای دو نود. |
| مقدار | معنی |
|---|---|
| 1 | نودها به یک سند مشترک تعلق ندارند. |
| 2 | نود اول پس از نود دوم قرار دارد. |
| 4 | نود اول قبل از نود دوم قرار دارد. |
| 8 | نود اول در داخل نود دوم قرار دارد. |
| 16 | نود دوم در داخل نود اول قرار دارد. |
| 32 | نود یک ویژگی است که در یک عنصر قرار دارد. |
پشتیبانی مرورگر
element.compareDocumentPosition() این یک ویژگی از DOM Level 1 (1998) است.
همه مرورگرها آن را کاملاً پشتیبانی می‌کنند:
| Chrome | IE | Edge | Firefox | Safari | Opera |
|---|---|---|---|---|---|
| Chrome | IE | Edge | Firefox | Safari | Opera |
| پشتیبانی | 9-11 | پشتیبانی | پشتیبانی | پشتیبانی | پشتیبانی |
- صفحه قبلی closest()
- صفحه بعدی contains()
- برگشت به طبقه بالاتر موضوع Elements DOM HTML
