大网数据广告活动
Web 标准与前端开发

Document:elementFromPoint() 方法

· 52CE 我爱测

Document 对象的 **`elementFromPoint()`** 方法返回给定相对于视口的坐标点下最上层的 Element。

DOM

Document 对象的 elementFromPoint() 方法返回给定相对于视口的坐标点下最上层的 Element。

如果指定位置的元素属于另一个文档(例如 iframe 的文档),则会返回该文档的父元素(<iframe> 本身)。如果给定点上的元素是匿名或 XBL 生成的内容(例如文本框的滚动条),则会返回第一个非匿名的祖先元素(例如文本框)。

pointer-events 设置为 none 的元素会被忽略,且将返回在该元素下方的元素。

如果该方法在另一个文档(如 <iframe> 的子文档)上运行,则坐标是相对于调用该方法的文档而言的。

如果指定的坐标点在文档的可视范围外,或者两个坐标都是负数,那么结果返回 null。

如果需要查找元素内部的特定位置,请使用 Document.caretPositionFromPoint()。

语法

elementFromPoint(x, y)

参数

  • x
    • : 坐标点的横坐标,相对于当前viewport的左边缘。
  • y
    • : 坐标点的纵坐标,相对于当前视口的上边缘。

返回值

在给定的坐标点处的最顶层 Element 对象。

示例

本例创建了两个按钮,用于设置位于坐标 (2, 2) 下的段落元素的当前颜色。

JavaScript

function changeColor(newColor) {
  elem = document.elementFromPoint(2, 2);
  elem.style.color = newColor;
}

changeColor() 方法获取位于指定点的元素,然后将该元素的当前前景 color 属性设置为 newColor 参数指定的颜色。

HTML

<p id="para1">一些文字</p>
<button onclick="changeColor('blue');">变蓝</button>
<button onclick="changeColor('red');">变红</button>

HTML 提供了颜色将受影响的段落,以及两个按钮:一个按钮用于将段落颜色更改为蓝色,另一个按钮用于将段落颜色更改为红色。

结果

示例

规范

浏览器兼容性

参见

  • Document.elementsFromPoint()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。