متد element.compareDocumentPosition
مثال (متد element.compareDocumentPosition)
پیدا کردن مکان یک پاراگراف و مقایسه کردن(مکان) آن با یک پاراگراف دیگر:
var p2 = document.getElementById("p2");
var x = p1.compareDocumentPosition(p2);
خروجی x در کد بالا
خودتان امتحان کنید »
تعریف و کاربرد
متد ()compareDocumentPosition دو گره را مقایسه می کند، و سپس یک عدد صحیح را که مشخص کننده ی مکان قرارگیری آن دو در سند است، برمی گرداند.
به مثال بالا توجه کنید.
مقادیر امکان پذیر عبارتند از:
1: هیچ ارتباطی وجود ندارد، دو گره مورد نظر به یک سند تعلق ندارند.
2: اولین گره(p1) بعد از گره دوم قرار دارد(p2).
4: اولین گره(p1) قبل از گره دوم قرار دارد(p2).
8:اولین گره(p1) درون گره دوم قرار گرفته است(p2).
16: دومین گره(p2) درون گره اول(p1) قرار گرفته است.
32: هیچ ارتباطی وجود ندارد، یا اینکه دوگره مورد نظر، دوخصوصیت در همان عنصر می باشند.
نکته: مقدار برگشتی همچنین می تواند ترکیبی از مقادیر باشد. بعنوان مثال مقدار برگشتی 20 بدین معنی است که p2 در درون p1 است(16) و p1 قبل از p2 قرار دارد(4).
پشتیبانی مرورگرها
اعداد داخل جدول زیر نشان دهنده ی اولین ورژن مرورگری است که به طور کامل از این متد پشتیبانی می کند.
متد | |||||
---|---|---|---|---|---|
compareDocumentPosition() | بله | 9.0 | بله | بله | بله |
نحوه استفاده
مقادیر پارامترها
پارامتر | Type | توضیحات |
---|---|---|
node | Node object |
ضروری. گره ای را مشخص می کند که می خواهیم آن را با گره کنونی مقایسه کنیم. |
جزئیات تکنیکی
مقدار برگشتی |
یک عدد، که مشخص کننده ی این است که دو گره مورد مقایسه از نظر مکان نسبت به یکدیگر در چه موقعیتی قرار می گیرند. مقادیر برگشتی امکان پذیر: 1. هیچ ارتباطی وجود ندارد، دو گره مورد نظر به یک سند تعلق ندارند. 2. اولین گره(p1) بعد از گره دوم قرار دارد(p2). 4.اولین گره(p1) بعد از گره دوم قرار دارد(p2) 8.اولین گره(p1) درون گره دوم قرار گرفته است(p2) 16.دومین گره(p2) درون گره اول(p1) قرار گرفته است. 32.هیچ ارتباطی وجود ندارد، یا اینکه دو گره مورد نظر دو خصوصیت در همان عنصر می باشند |
---|---|
DOM Version | Core Level 1 Node Object |
کلیه توابع و خصوصیت های شیء Element در JavaScript
- نوشته شده توسط احسان عباسی
- بازدید: 5009