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

Node.compareDocumentPosition

· 52CE 我爱测

`Node.compareDocumentPosition()`** 可以比较当前节点与任意文档中的另一个节点的位置关系。

DOM

Node.compareDocumentPosition() 可以比较当前节点与任意文档中的另一个节点的位置关系。

返回值是一个具有以下值的位掩码:

常量名 十进制值 含义
DOCUMENT_POSITION_DISCONNECTED 1 不在同一文档中
DOCUMENT_POSITION_PRECEDING 2 otherNode 在 node 之前
DOCUMENT_POSITION_FOLLOWING 4 otherNode 在 node 之后
DOCUMENT_POSITION_CONTAINS 8 otherNode 包含 node
DOCUMENT_POSITION_CONTAINED_BY 16 otherNode 被 node 包含
DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC 32 待定

语法

compareDocumentPosition(otherNode)

参数

  • otherNode
    • : 用于比较位置的 Node 。

返回值

一个表示 Node 和 otherNode 在 Document 中关系的整数值。在一些场景下,可能设置了不止一位比特值。比如 otherNode 在文档中是靠前的且包含了 Node, 那么DOCUMENT_POSITION_CONTAINS 和 DOCUMENT_POSITION_PRECEDING 位都会设置,所以结果会是 0x0A 即十进制下的 10。

例子

var head = document.getElementsByTagName("head").item(0);
if (
  head.compareDocumentPosition(document.body) & Node.DOCUMENT_POSITION_FOLLOWING
) {
  console.log("well-formed document");
} else {
  console.log("<head> is not before <body>");
}

[!NOTE] 因为compareDocumentPosition返回的是一个位掩码,所以必须再使用按位与运算符才能得到有意义的值。

注意第一条语句使用了带有参数 0 的 NodeList.item() 方法,它和 getElementsByTagName('head')[0] 是一样的。

规范

浏览器兼容性

相关链接

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

资料来源与适用范围

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

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

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