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

Text:wholeText 属性

· 52CE 我爱测

Text 接口的 **`wholeText`** 只读属性返回与该节点逻辑上相邻的所有 Text 节点的完整文本。文本按文档顺序进行拼接。这样就允许指定任意文本节点并将所有相邻文本作为一个字符串获取。

DOM

Text 接口的 wholeText 只读属性返回与该节点逻辑上相邻的所有 Text 节点的完整文本。文本按文档顺序进行拼接。这样就允许指定任意文本节点并将所有相邻文本作为一个字符串获取。

[!NOTE] 这类似于调用 Node.normalize() 之后读取文本值,但不会修改树。

值

包含连接文本的字符串。

示例

假设你的网页中有以下简单的段落:

<p>
  徒步旅行很不错!
  <strong>平淡无奇的选举报道!</strong>
  然而,<a href="https://zh.wikipedia.org/wiki/缺席投票">投票</a
  >是一件棘手的事情。
</p>

你决定不喜欢中间的句子,所以把它去掉了:

const paragraph = document.querySelector("p"); // 读取该段
paragraph.removeChild(paragraph.childNodes[1]); // 删除 strong 元素

现在你的结果是 “徒步旅行很不错!然而,投票是一件棘手的事情。",超链接前有两个节点:

  1. 包含字符串 "徒步旅行很不错!" 的 Text 节点
  2. 第二个 Text 节点,包含字符串 "然而,"

要同时获取这两个节点,你可以调用 paragraph.childNodes[0].wholeText:

console.log(`'${paragraph.childNodes[0].wholeText}'`); // '徒步旅行很不错!然而, '

规范

浏览器兼容性

参见

  • 所属的 Text 接口。

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

资料来源与适用范围

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

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

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