此页面由社区从英文翻译而来。了解更多并加入 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

浏览器兼容性

参见