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

Node.getRootNode()

· 52CE 我爱测

Node 接口的 **`getRootNode()`** 方法返回上下文中的根节点,如果 shadow DOM 可用,则对 shadow DOM 同样适用。

DOM

Node 接口的 getRootNode() 方法返回上下文中的根节点,如果 shadow DOM 可用,则对 shadow DOM 同样适用。

语法

var root = node.getRootNode(options);

参数

  • options
    • : 获取根节点时的可选参数对象。下列值可供选择:
      • composed: Boolean 如果检索到 shadow Root 需要返回,则设置为(false,默认值),如果跳过 shadow Root 检索普通 Root 则设置为(true)。

返回值

返回一个继承自 Node 的对象。返回值会因为 getRootNode() 调用的地方不同而不同; 比如说:

  • 在标准的网页中调用将会返回一个 HTMLDocument 对象表示整个网页。
  • 在 Shadow DOM 里调用将会返回一个与之相关联的 ShadowRoot 。

示例

第一个例子很简单,返回一个参照 HTML/document node 位置的一个节点。

rootNode = node.rootNode;

我们来看一个稍微复杂的例子。这个例子展示了该属性在普通的 DOM 的 shadow DOM 的差别。 (See the full source code):


<div class="js-parent">
  <div class="js-child"></div>
</div>
<div class="js-shadowHost"></div>
<script>
  // work on Chrome 54+,Opera41+

  var parent = document.querySelector(".js-parent"),
    child = document.querySelector(".js-child"),
    shadowHost = document.querySelector(".js-shadowHost");

  console.log(parent.getRootNode().nodeName); // #document
  console.log(child.getRootNode().nodeName); // #document

  // create a ShadowRoot
  var shadowRoot = shadowHost.attachShadow({ mode: "open" });
  shadowRoot.innerHTML =
    "<style>div{background:#2bb8aa;}</style>" +
    '<div class="js-shadowChild">content</div>';
  var shadowChild = shadowRoot.querySelector(".js-shadowChild");

  // The default value of composed is false
  console.log(shadowChild.getRootNode() === shadowRoot); // true
  console.log(shadowChild.getRootNode({ composed: false }) === shadowRoot); // true
  console.log(shadowChild.getRootNode({ composed: true }).nodeName); // #document
</script>

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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