HTMLElement:outerText 属性

outerTextHTMLElement 接口的一个属性,它返回与 HTMLElement.innerText 相同的值。当用作设置器时,它会用给定的文本替换整个当前节点(这与 innerText 不同,后者替换当前节点内部的内容)。

有关更多信息和示例,请参阅 HTMLElement.innerText,这些示例展示了这两个属性如何用作获取器。

一个字符串,表示元素及其后代的渲染文本内容。

如果元素本身未被渲染(例如,与文档分离或隐藏),则返回的值与 Node.textContent 属性相同。

用作设置器时,它会用给定的文本替换当前节点,并将任何换行符转换为 <br> 元素。

示例

此示例突出了 outerTextinnerText 用作设置器时的根本区别(用作获取器时它们是相同的)。

注意:此示例是 innerText 和 outerText 之间有什么区别?(Stack Overflow)的修改版本,由 codingintrigue 撰写,根据 CC BY-SA 3.0 许可。

假设一个页面包含以下 HTML

html
<div>
  <p>Original content</p>
</div>

outerText 替换整个选定的元素,因此 JavaScript p.outerText = "Whole element replaced" 替换整个选定的 p 元素

html
<div>Whole element replaced</div>

相比之下,p.innerText = "Content inside element replaced" 替换选定的 p 元素内部的内容

html
<div>
  <p>Content inside element replaced</p>
</div>

规范

规范
HTML 标准
# dom-outertext

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅