`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