此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Range:createContextualFragment() 方法

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

Range.createContextualFragment() 方法通过以范围的起始位置(即所选节点的节点)作为上下文节点,调用 HTML 片段解析算法或 XML 片段解析算法,返回一个 DocumentFragment。如果该范围属于一个已设置 HTMLness 位的 Document,则会使用 HTML 片段解析算法。在 HTML 的情况下,出于历史原因,如果上下文节点是 html,片段解析算法则会改为使用 body 作为上下文执行。

语法

js
createContextualFragment(tagString)

参数

tagString

包含要转换为文档片段的文本和标签。

返回值

DocumentFragment 对象。

示例

js
const tagString = "<div>我是一个 div 节点</div>";
const range = document.createRange();

// 让文档中第一个 div 元素的父元素成为上下文节点
range.selectNode(document.getElementsByTagName("div").item(0));
const documentFragment = range.createContextualFragment(tagString);
document.body.appendChild(documentFragment);

规范

Specification
HTML
# dom-range-createcontextualfragment

浏览器兼容性

参见