From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/zh-cn/web/api/text/splittext/index.html | 127 ++++++++++++++++++++++++++ 1 file changed, 127 insertions(+) create mode 100644 files/zh-cn/web/api/text/splittext/index.html (limited to 'files/zh-cn/web/api/text/splittext') diff --git a/files/zh-cn/web/api/text/splittext/index.html b/files/zh-cn/web/api/text/splittext/index.html new file mode 100644 index 0000000000..4ad321bf85 --- /dev/null +++ b/files/zh-cn/web/api/text/splittext/index.html @@ -0,0 +1,127 @@ +--- +title: Text.splitText() +slug: Web/API/Text/splitText +tags: + - API + - DOM + - Text + - 方法 +translation_of: Web/API/Text/splitText +--- +
{{apiref("DOM")}}
+ +

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

+ +

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

+ +

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

+ +

语法

+ +
newNode = textNode.splitText(offset)
+
+ +

参数

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

返回值

+ +

返回一个新创建的 {{domxref("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>
+
+ +

结果

+ +

{{EmbedLiveSample("Example", 700, 70)}}

+ +

规范

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
规范状态备注
{{SpecName('DOM WHATWG', '#dom-text-splittext', 'Text.splitText')}}{{Spec2('DOM WHATWG')}}No change from {{SpecName('DOM3 Core')}}.
{{SpecName('DOM3 Core', 'core.html#ID-38853C1D', 'Text.splitText')}}{{Spec2('DOM3 Core')}}No change from {{SpecName('DOM2 Core')}}.
{{SpecName('DOM2 Core', 'core.html#ID-38853C1D', 'Text.splitText')}}{{Spec2('DOM2 Core')}}No change from {{SpecName('DOM1')}}.
{{SpecName('DOM1', 'level-one-core.html#ID-38853C1D', 'Text.splitText')}}{{Spec2('DOM1')}}Initial definition.
+ +

浏览器兼容性

+ + + +

{{Compat("api.Text.splitText")}}

+ +

参见

+ + + +
+
+
-- cgit v1.2.3-54-g00ecf