浏览器与 Web API / 系统课时
textContent 与 innerText
textContent 与 innerText
读取或修改元素文字时,textContent 与 innerText 看似相同,实际关注的内容范围和浏览器成本不同。本课通过可运行示例比较两者,并给出面向普通文本、可见文本和性能场景的选择规则。
学习目标
- 说明
textContent与innerText的读取范围差异 - 验证隐藏内容、换行和写入 HTML 字符串时的行为
- 根据安全性、性能和展示需求选择合适属性
两者读取的不是同一种“文本”
textContent 直接汇总当前节点及其后代的文本节点,不关心元素是否被 CSS 隐藏,也不按照页面布局重新组织换行。它更接近 DOM 中实际保存的文字数据。
innerText 关注渲染后的可见文本。读取时会考虑 display: none、换行和块级布局等结果,因此更接近用户复制页面时得到的内容。为了获得这些信息,浏览器可能需要计算样式或布局,频繁读取时成本通常高于 textContent。
| 对比项 | textContent |
innerText |
|---|---|---|
| 隐藏元素文字 | 通常包含 | 通常忽略 |
| 页面换行 | 不按布局生成 | 按渲染结果生成 |
| 读取成本 | 通常较低 | 可能触发布局计算 |
| 写入 HTML 字符串 | 作为纯文本 | 作为纯文本 |
主示例:观察隐藏文本与换行
将下面内容保存为 index.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>预期输出
"可见文本隐藏文本下一行"
"可见文本\n下一行"
<b>安全文本</b>第二行中的 \n 表示渲染产生的换行。不同浏览器对复杂布局的空白处理可能略有差异,但隐藏文本是否出现、字符串是否被当作标签解析这两个结论不会改变。
写入行为与选择规则
给 textContent 赋值会删除元素原有的全部子节点,再创建一个文本节点。已有的按钮、图标和事件绑定节点都会被移除,因此不要把它用于“只改其中一小段文字”的场景。
给 innerText 赋值同样不会解析 HTML,但会按照可见文本规则处理换行;多行字符串可能被转换为页面中的换行结构。只需要显示接口返回值、用户名或日志片段时,优先使用 textContent,语义更直接,也不会产生额外的布局依赖。
需要读取 DOM 中完整文字、批量处理文本或高频更新内容时,使用 textContent。需要获得用户实际看到并可复制的文本,例如导出文章可见内容时,再使用 innerText。
不要通过 innerText 判断元素是否真正可见。元素可能位于视口外、被遮挡或透明度为零,这些情况仍需要结合布局尺寸、样式或可见性 API 单独判断。