initial commit

1 files changed, 96 insertions, 0 deletions

diff --git a/files/zh-cn/web/api/node/getrootnode/index.html b/files/zh-cn/web/api/node/getrootnode/index.html
new file mode 100644
index 0000000000..97b25f6f8f
--- /dev/null
+++ b/files/zh-cn/web/api/node/getrootnode/index.html
@@ -0,0 +1,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>