文本 | Web API

在此页

构造函数
特性
方法
规范
浏览器兼容性
另请参阅
相关话题

文本 接口表示正文内容在 元素 or Attr .

If an element has no markup within its content, it has a single child implementing 文本 that contains the element's text. However, if the element contains markup, it is parsed into information items and 文本 nodes that form its children.

New documents have a single 文本 node for each block of text. Over time, more 文本 nodes may be created as the document's content changes. The Node.normalize() method merges adjacent 文本 objects back into a single node for each block of text.

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="../API/EventTarget.html" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25  236,20  236,30  226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/CharacterData" target="_top"><rect x="266" y="1" width="130" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="331" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">CharacterData</text></a><polyline points="396,25  406,20  406,30  396,25" stroke="#D4DDE4" fill="none"/><line x1="406" y1="25" x2="436" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/Text" target="_top"><rect x="436" y="1" width="75" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="473.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Text</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

构造函数

Text(): 返回 文本 node with the parameter as its textual content.

特性

继承的特性来自其父级， CharacterData .

Text.isElementContentWhitespace 只读
Text.wholeText 只读: 返回 DOMString containing the text of all 文本 nodes logically adjacent to this 节点 , concatenated in document order.
Text.assignedSlot 只读: 返回 HTMLSlotElement object associated with the element.

包括来自 Slotable 的特性

文本 接口包括以下特性，定义在 Slotable 混合。

Slotable.assignedSlot 只读: 返回 HTMLSlotElement 表示 <slot> 被插入节点。

方法

继承方法来自其父级 CharacterData .

Text.replaceWholeText

Text.splitText

规范

规范	状态	注释
DOM The definition of 'Text' in that specification.	实时标准	移除 `isElementContentWhitespace` 特性。移除 `replaceWholeText()` 方法。添加 `Text()` 构造函数。添加 `assignedSlot` 特性。
DOM (文档对象模型) 3 级核心规范 The definition of 'Text' in that specification.	过时	添加 `isElementContentWhitespace` and `wholeText` 特性。添加 `replaceWholeText()` 方法。
DOM (文档对象模型) 级别 2 核心规范 The definition of 'Text' in that specification.	过时	无变化自 DOM (文档对象模型) 1 级规范 .
DOM (文档对象模型) 1 级规范 The definition of 'Text' in that specification.	过时	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`文本`	Chrome 1	Edge 12	Firefox Yes	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android ?	Firefox Android Yes	Opera Android Yes	Safari iOS Yes	Samsung Internet Android ?
`Text()` 构造函数	Chrome 28	Edge ≤79	Firefox 24	IE No	Opera 15	Safari 8	WebView Android Yes	Chrome Android 28	Firefox Android 24	Opera Android 14	Safari iOS 8	Samsung Internet Android 2.0
`assignedSlot`	Chrome 53	Edge ≤18	Firefox Yes	IE ?	Opera 40	Safari 10.1	WebView Android 53	Chrome Android 53	Firefox Android Yes	Opera Android 41	Safari iOS 10.3	Samsung Internet Android 6.0
`isElementContentWhitespace` 弃用	Chrome No	Edge No	Firefox ? — 10	IE No	Opera No	Safari No	WebView Android No	Chrome Android No	Firefox Android ? — 10	Opera Android No	Safari iOS No	Samsung Internet Android No
`replaceWholeText` 弃用非标	Chrome ? — 45	Edge 12 — 79	Firefox ? — 10	IE Yes	Opera ? — 32	Safari No	WebView Android ? — 45	Chrome Android ? — 45	Firefox Android ? — 10	Opera Android ? — 32	Safari iOS No	Samsung Internet Android ? — 5.0
`splitText`	Chrome 1 1 Before Chrome 30, the `offset` argument was optional.	Edge 12	Firefox 1	IE Yes	Opera Yes Yes Before Opera 17, the `offset` argument was optional.	Safari Yes Yes `offset` argument is optional.	WebView Android Yes Yes Before version 4.4, the `offset` argument was optional.	Chrome Android 18 18 Before Chrome 30, the `offset` argument was optional.	Firefox Android 4	Opera Android Yes Yes Before Opera 17, the `offset` argument was optional.	Safari iOS Yes Yes `offset` argument is optional.	Samsung Internet Android 1.0 1.0 Before Samsung Internet 2.0, the `offset` argument was optional.
`wholeText`	Chrome 1	Edge 12	Firefox 3.5	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android ?	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android ?

图例

完整支持
不支持
兼容性未知 ?
实验。期望将来行为有所改变。
非标。预期跨浏览器支持较差。
弃用。不要用于新网站。

另请参阅

The DOM interfaces index .

元数据

最后修改： Aug 5, 2020

DOM (文档对象模型)
文本
构造函数
1. Text()
特性
方法
1. ~~replaceWholeText()~~
2. splitText()
继承：
DOM 相关页面

在此页

构造函数

特性

包括来自 Slotable 的特性

方法

规范

浏览器兼容性

图例

另请参阅

相关话题