大网数据广告活动
Web 标准与前端开发

HTMLElement.outerText

· 52CE 我爱测

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

DOM

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

请参阅 HTMLElement.innerText 以了解更多信息和有关两个属性用作 getter 的示例。

值

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

如果这个元素本身没有被渲染(例如,从文档中分离或是从视图中隐藏),返回值与 Node.textContent 属性的返回值相同。

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

示例

这个例子突出了 outerText 和 innerText 在用作 setter 时的根本区别(它们用做 getter 时行为完全一致)。

[!NOTE] 这个示例是 innerText 和 outerText 有什么区别?(Stack overflow)的修订后的版本,由 codingintrigue 发起,基于 CC BY-SA 3.0 许可证发布。

考虑包含如下 HTML 代码的页面:

<div>
  <p>原始内容</p>
</div>

outerText 替换了整个选中的元素,因此 JavaScript 语句 p.outerText = "整个元素已替换" 替换了整个选中的 p 元素:

<div>整个元素已替换</div>

相比之下,p.innerText = "元素内容已替换" 替换了所选中的 p 元素的内部内容:

<div>
  <p>元素内容已替换</p>
</div>

规范

浏览器兼容性

参见

  • HTMLElement.innerText
  • Element.outerHTML

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。