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
参数是可选的。