Text - 表示 Element 或 Attr 的文本内容
Text 接口表示 Element 或 Attr 的文本内容。
如果一个元素在其内容内没有标记,则它只有一个实现包含元素文本的 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 的定义 |
已过时 | 添加了 isElementContentWhitespace 和 wholeText 属性。添加了 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 的定义 |
已过时 | 初始定义。 |
桌面浏览器兼容性
| 特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| 基础支持 | 1 | 12 | 支持 | 支持 | 支持 | 支持 |
Text() 构造函数 | 28 | ≤79 | 24 | 不支持 | 15 | 8 |
assignedSlot | 53 | ≤18 | 支持 | 未知 | 40 | 10.1 |
isElementContentWhitespace | 不支持 | 不支持 | 支持 — 10 | 不支持 | 不支持 | 不支持 |
replaceWholeText | 支持 — 45 | 12 — 79 | 支持 — 10 | 支持 | 支持 — 32 | 不支持 |
splitText | 11 | 12 | 1 | 支持 | 支持2 | 支持3 |
wholeText | 1 | 12 | 3.5 | 支持 | 支持 | 支持 |
移动浏览器兼容性
| 特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
|---|---|---|---|---|---|---|---|
| 基础支持 | 支持 | 未知 | 未知 | 支持 | 未知 | 支持 | 支持 |
Text() 构造函数 | 支持 | 28 | 未知 | 24 | 未知 | 14 | 8 |
assignedSlot | 53 | 53 | 未知 | 支持 | 未知 | 41 | 10.3 |
isElementContentWhitespace | 不支持 | 不支持 | 未知 | 支持 — 10 | 未知 | 不支持 | 不支持 |
replaceWholeText | 支持 — 45 | 支持 — 45 | 未知 | 支持 — 10 | 未知 | 支持 — 32 | 不支持 |
splitText | 支持5 | 181 | 未知 | 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 参数是可选的。