Text.splitText()

Text.splitText() 方法可以根据指定的偏移量将一个 Text 节点分割成前后两个独立的兄弟节点。

如果指定的偏移量刚好等于原文本节点所包含字符串的长度,则返回一个内容为空的文本节点.

分割后的文本节点还可以使用Node.normalize方法来合并.

语法

newNode = textNode.splitText(offset)

参数

offset
在中断文本节点前的索引。

返回值

返回一个新创建的 Text 节点,该节点包含了 the text after the specified offset point.

异常

INDEX_SIZE_ERR
如果指定的偏移量小于0或者大于原文本节点中所包含字符串的长度,则抛出这个异常.
NO_MODIFICATION_ALLOWED_ERR
如果,原文本节点只读,则抛出这个异常.

例子

下面的例子中,一个 <p> 元素所包含的文本节点将会被分割成两个文本节点,然后在这两个节点中间插入一个 <span> 元素。

HTML

  <p id="p">foobar</p>

JavaScript

const  p = document.getElementById('p');

// 将 <p> 的内容读取为一个文本节点
const foobar = p.firstChild;

// 将原来的文本节点分割成为内容分别为 foo 和 bar 的两个文本节点
const bar = foobar.splitText(3);

// 创建一个包含了内容为 ' new content ' 的文本节点的 <u> 元素
const u = document.createElement('u');
u.appendChild(document.createTextNode(' new content '));

// 将 <u> 元素插入到后一个文本节点 'bar' 的前面
p.insertBefore(u, bar);

// 现在,HTML 结构就变成了 <p id="p">foo <span>span contents</span> bar</p>

结果

规范

规范 状态 备注
DOM
Text.splitText
Living Standard No change from Document Object Model (DOM) Level 3 Core Specification.
Document Object Model (DOM) Level 3 Core Specification
Text.splitText
Obsolete No change from Document Object Model (DOM) Level 2 Core Specification.
Document Object Model (DOM) Level 2 Core Specification
Text.splitText
Obsolete No change from Document Object Model (DOM) Level 1 Specification.
Document Object Model (DOM) Level 1 Specification
Text.splitText
Obsolete Initial definition.

浏览器兼容性

BCD tables only load in the browser

参见