Document.elementFromPoint()
تنبيه: هذه تقنيّة تجريبيّة، انظر جدول دعم المتصفّحات قبل استخدام هذا التّابع في شيفرة إنتاجيّة.
يعيد التّابع Document.elementFromPoint() العنصر الموجود في أعلى الإحداثيّات المعطاة (حسب إطار العرض (viewport)).
إن كان العنصر في النّقطة المحدّدة خاصًّا بمستند آخر (مثل مستند فرعيّ لعنصر iframe مثلًا)، فالعنصر الأب للمستند الفرعيّ هو الذي يُعاد (أي عنصر iframe نفسه). إن كان العنصر في النّقطة المُعطاة مجهولًا (anonymous) أو محتوًى مولَّدًا عبر XBL، مثل شريط التمرير (scroll bar) في صندوقٍ نصيّ، فأول عنصرٍ أبٍ غير مجهولٍ هو الذي يُعاد (الصّندوق النّصيّ مثلًا).
إن كانت النّقطة المعطاة خارج حدود المستند الظّاهرة أو أحد الإحداثيّات سلبيًّا، فالنّتيجة ستكون القيمة null.
إن أردت أن تجد الموقع المحدّد بالضّبط داخل العنصر، فاستخدم التّابع Document.caretPositionFromPoint().
البنية العامة
var element = document.elementFromPoint(x, y);
المعاملات
x
الإحداثيّ الأفقيّ لنقطة ما.
y
الإحداثيّ العمودي لنقطة ما.
القيمة المعادة
كائن من النّوع Element يمثّل أعلى عنصر تحت النّقطتين المعطيين.
مثال
<!DOCTYPE html>
<html lang="en">
<head>
<title>elementFromPoint مثال</title>
<script>
function changeColor(newColor) {
elem = document.elementFromPoint(2, 2);
elem.style.color = newColor;
}
</script>
</head>
<body>
<p id="para1">محتوى نصيّ</p>
<button onclick="changeColor('blue');">أزرق</button>
<button onclick="changeColor('red');">أحمر</button>
</body>
</html>
دعم المتصفّحات
| الميزة | Chrome | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| الدعم الأساسي | 53 | نعم | نعم | 40 | نعم |
مصادر ومواصفات
- مواصفة Shadow DOM