Text - 表示 Element 或 Attr 的文本内容

Text 接口表示 ElementAttr 的文本内容。

如果一个元素在其内容内没有标记,则它只有一个实现包含元素文本的 Text 子元素。但是,如果元素包含标记,则将其解析为构成其子元素的信息项和 Text 节点。

新文档的每个文本块都有一个 Text 节点。随着时间的变化,随着文档内容的更改,可能会创建更多的 Text 节点。 Node.normalize() 方法将相邻的 Text 对象合并回每个文本块的单个节点中。

构造函数

Text()

返回将参数作为其文本内容的 Text 节点。

属性

从其父接口 CharacterData 继承了属性。

Text.isElementContentWhitespace 只读

返回一个 Boolean 标志,指示文本节点是否仅包含空格。

Text.wholeText 只读

返回一个 DOMString,其中包含在逻辑上与此 Node 相邻的所有 Text 节点的文本,并按文档顺序连接。

Text.assignedSlot 只读

返回与元素关联的 HTMLSlotElement 对象。

Slotable 包含的属性

Text 接口包含以下属性,这些属性是在 Slotable mixin 上定义的。

Slotable.assignedSlot 只读

返回表示插入节点的 <slot>HTMLSlotElement

方法

从其父接口 CharacterData 继承了方法。

Text.replaceWholeText

用指定的文本替换当前节点和所有逻辑上相邻的节点的文本。

Text.splitText

以指定的偏移量将节点分为两个节点。

规范

规范 状态 备注
DOM
Text 的定义
现行的标准 移除了 isElementContentWhitespace 属性。
删除了 replaceWholeText() 方法。
添加了 Text() 构造函数。
添加了 assignedSlot 属性。
Document Object Model (DOM) Level 3 Core Specification
Text 的定义
已过时 添加了 isElementContentWhitespacewholeText 属性。
添加了 replaceWholeText() 方法。
Document Object Model (DOM) Level 2 Core Specification
Text 的定义
已过时 Document Object Model (DOM) Level 1 Specification 以来没有变化。
Document Object Model (DOM) Level 1 Specification
Text 的定义
已过时 初始定义。

桌面浏览器兼容性

特性ChromeEdgeFirefoxInternet ExplorerOperaSafari
基础支持112 支持 支持 支持 支持
Text() 构造函数28≤7924 不支持158
assignedSlot53≤18 支持 未知4010.1
isElementContentWhitespace 不支持 不支持 支持 — 10 不支持 不支持 不支持
replaceWholeText 支持 — 4512 — 79 支持 — 10 支持 支持 — 32 不支持
splitText11121 支持 支持2 支持3
wholeText1123.5 支持 支持 支持

移动浏览器兼容性

特性AndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
基础支持 支持 未知 未知 支持 未知 支持 支持
Text() 构造函数 支持28 未知24 未知148
assignedSlot5353 未知 支持 未知4110.3
isElementContentWhitespace 不支持 不支持 未知 支持 — 10 未知 不支持 不支持
replaceWholeText 支持 — 45 支持 — 45 未知 支持 — 10 未知 支持 — 32 不支持
splitText 支持5181 未知4 未知 支持2 支持3
wholeText 支持 未知 未知4 未知 支持 支持

1. 在 Chrome 30 之前,offset 参数是可选的。

2. 在 Opera 17 之前,offset 参数是可选的。

3. offset 参数是可选的。

4. 在 Samsung Internet 2.0 之前,offset 参数是可选的。

5. 在 4.4 版之前,offset 参数是可选的。