files/zh-cn/web/api/node/getrootnode/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

---
title: Node.getRootNode()
slug: Web/API/Node/getRootNode
tags:
  - API
  - DOM
  - Node
  - 参考
  - 方法
translation_of: Web/API/Node/getRootNode
---
<p>{{APIRef("DOM")}}</p>

<p>{{domxref("Node")}} 接口的 <strong><code>getRootNode()</code></strong> 方法返回上下文中的根节点，如果 shadow DOM 可用，则对 shadow DOM 同样适用。</p>

<h2 id="语法">语法</h2>

<pre class="syntaxbox">var <var>root</var> = <var>node</var>.getRootNode(<var>options</var>);</pre>

<h3 id="参数">参数</h3>

<dl>
 <dt><code>options</code> {{optional_inline}}</dt>
 <dd>获取根节点时的可选参数对象. 下列值可供选择:
 <ul>
  <li><code>composed</code>:  {{jsxref('Boolean')}} 如果检索到 shadow Root 需要返回，则设置为（<code>false</code>，默认值），如果跳过shadow Root 检索普通Root则设置为（<code>true</code>）。</li>
 </ul>
 </dd>
</dl>

<h3 id="返回值">返回值</h3>

<p>返回一个继承自 {{domxref('Node')}} 的对象。返回值会因为 <code>getRootNode()</code> 调用的地方不同而不同; 比如说:</p>

<ul>
 <li>在标准的网页中调用将会返回一个 {{domxref("HTMLDocument")}} 对象表示整个网页。</li>
 <li>在Shadow DOM里调用将会返回一个与之相关联的 {{domxref("ShadowRoot")}} 。</li>
</ul>

<h2 id="示例">示例</h2>

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

<pre class="brush: js"><code class="language-html">rootNode = node.rootNode;</code></pre>

<p>我们来看一个稍微复杂的例子。这个例子展示了该属性在普通的 DOM 的 shadow DOM 的差别。 (See the <a href="https://github.com/jserz/js_piece/blob/master/DOM/Node/getRootNode()/demo/getRootNode.html">full source code</a>):</p>

<pre class="brush: html">&lt;!-- source: https://github.com/jserz/js_piece/blob/master/DOM/Node/getRootNode()/demo/getRootNode.html --&gt;
&lt;div class="js-parent"&gt;
    &lt;div class="js-child"&gt;&lt;/div&gt;
&lt;/div&gt;
&lt;div class="js-shadowHost"&gt;&lt;/div&gt;
&lt;script&gt;
    // 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 = '&lt;style&gt;div{background:#2bb8aa;}&lt;/style&gt;'
        + '&lt;div class="js-shadowChild"&gt;content&lt;/div&gt;';
    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
&lt;/script&gt;</pre>

<h2 id="规格">规格</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">规范</th>
   <th scope="col">状态</th>
   <th scope="col">备注</th>
  </tr>
  <tr>
   <td>{{SpecName('DOM WHATWG','#dom-node-getrootnode','getRootNode()')}}</td>
   <td>{{Spec2('DOM WHATWG')}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>


<p>{{Compat("api.Node.getRootNode")}}</p>