---
title: Range.createContextualFragment()
slug: Web/API/Range/createContextualFragment
translation_of: Web/API/Range/createContextualFragment
---
<div>{{ApiRef("DOM")}}</div>

<p><strong><code>Range.createContextualFragment()</code></strong> 方法通过以 range 的开头（选定节点的父级）作为上下文节点来调用 HTML 片段解析算法 或者 XML 片段解析算法来返回 {{domxref("DocumentFragment")}}。如果 range 属于一个其 HTMLness bit 被设置了的  {{domxref("Document")}} 则会应用 HTML 片段解析算法。在 HTML 的情况下，如果上下文节点为 html，由于历史原因，将使用 body 作为上下文来调用片段解析算法。</p>

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

<pre class="syntaxbox notranslate"><em>documentFragment</em> = <em>range</em>.createContextualFragment(<em>tagString</em>)
</pre>

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

<dl>
 <dt><code>tagString</code></dt>
 <dd>包含要转换为文档片段的文本和标签的文本。</dd>
</dl>

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

<pre class="brush: js notranslate">var tagString = "&lt;div&gt;I am a div node&lt;/div&gt;";
var range = document.createRange();

// 使文档中第一个 div 的父级成为上下文节点
range.selectNode(document.getElementsByTagName("div").item(0));
var documentFragment = range.createContextualFragment(tagString);
document.body.appendChild(documentFragment);
</pre>

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

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('DOM Parsing', '#dom-range-createcontextualfragment', 'Range.createContextualFragment()')}}</td>
   <td>{{Spec2('DOM Parsing')}}</td>
   <td>Initial specification.</td>
  </tr>
 </tbody>
</table>

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



<p>{{Compat("api.Range.createContextualFragment")}}</p>

<h2 id="See_also">See also</h2>

<ul>
 <li><a href="/en-US/docs/DOM/DOM_Reference" title="/en-US/docs/DOM/DOM_Reference">The DOM interfaces index</a></li>
</ul>