浏览器与 Web API / 系统课时

textContent 与 innerText

textContent 与 innerText

读取或修改元素文字时,textContent 与 innerText 看似相同,实际关注的内容范围和浏览器成本不同。本课通过可运行示例比较两者,并给出面向普通文本、可见文本和性能场景的选择规则。

学习目标

  • 说明 textContent 与 innerText 的读取范围差异
  • 验证隐藏内容、换行和写入 HTML 字符串时的行为
  • 根据安全性、性能和展示需求选择合适属性

两者读取的不是同一种“文本”

textContent 直接汇总当前节点及其后代的文本节点,不关心元素是否被 CSS 隐藏,也不按照页面布局重新组织换行。它更接近 DOM 中实际保存的文字数据。

innerText 关注渲染后的可见文本。读取时会考虑 display: none、换行和块级布局等结果,因此更接近用户复制页面时得到的内容。为了获得这些信息,浏览器可能需要计算样式或布局,频繁读取时成本通常高于 textContent。

对比项 textContent innerText
隐藏元素文字 通常包含 通常忽略
页面换行 不按布局生成 按渲染结果生成
读取成本 通常较低 可能触发布局计算
写入 HTML 字符串 作为纯文本 作为纯文本

主示例:观察隐藏文本与换行

将下面内容保存为 index.html 后直接用浏览器打开。示例把标签写在同一行,避免源码缩进产生额外空白文本。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>文本属性比较</title>
</head>
<body>
  <div id="box">可见文本<span hidden>隐藏文本</span><div>下一行</div></div>
  <script>
    const box = document.querySelector("#box");

    // textContent 读取 DOM 中全部文本,innerText 读取渲染后的可见文本。
    console.log(JSON.stringify(box.textContent));
    console.log(JSON.stringify(box.innerText.replace(/\r/g, "")));

    // 写入 textContent 时,尖括号不会被解析为元素。
    box.querySelector("div").textContent = "<b>安全文本</b>";
    console.log(box.querySelector("div").innerHTML);
  </script>
</body>
</html>

预期输出

text
"可见文本隐藏文本下一行"
"可见文本\n下一行"
&lt;b&gt;安全文本&lt;/b&gt;

第二行中的 \n 表示渲染产生的换行。不同浏览器对复杂布局的空白处理可能略有差异,但隐藏文本是否出现、字符串是否被当作标签解析这两个结论不会改变。

写入行为与选择规则

给 textContent 赋值会删除元素原有的全部子节点,再创建一个文本节点。已有的按钮、图标和事件绑定节点都会被移除,因此不要把它用于“只改其中一小段文字”的场景。

给 innerText 赋值同样不会解析 HTML,但会按照可见文本规则处理换行;多行字符串可能被转换为页面中的换行结构。只需要显示接口返回值、用户名或日志片段时,优先使用 textContent,语义更直接,也不会产生额外的布局依赖。

需要读取 DOM 中完整文字、批量处理文本或高频更新内容时,使用 textContent。需要获得用户实际看到并可复制的文本,例如导出文章可见内容时,再使用 innerText。

不要通过 innerText 判断元素是否真正可见。元素可能位于视口外、被遮挡或透明度为零,这些情况仍需要结合布局尺寸、样式或可见性 API 单独判断。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

textContent 与 innerText

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通