JavaScript / TypeScript / 系统课时
读取与修改元素内容
读取与修改元素内容
页面交互通常需要读取已有文本、更新提示信息或动态生成内容。JavaScript 提供了 textContent、innerText 和 innerHTML 三种常用方式,它们看似都能修改内容,但处理文本、样式和 HTML 结构的方式不同。本篇将学习如何根据场景选择正确的方法。
学习目标
- 理解
textContent、innerText和innerHTML的区别。 - 掌握读取和修改 DOM 内容的基本方式。
- 知道什么时候应该避免直接使用
innerHTML。
使用 textContent 处理纯文本
textContent 用于读取或设置元素中的纯文本内容。它不会解析 HTML 标签,而是把内容作为普通文字处理。
例如:
<p id="message">欢迎学习 JavaScript</p>const message = document.querySelector('#message');
console.log(message.textContent);
message.textContent = '开始学习 DOM';预期输出
欢迎学习 JavaScript预期结果
页面中的 p 元素显示“开始学习 DOM”。当只是更新提示语、标题、按钮文字时,textContent 通常是最安全的选择。
使用 innerText 获取可见文本
innerText 关注用户实际看到的文字。它会考虑 CSS 样式影响,例如隐藏元素不会被读取。
例如:
<div id="info">可见内容<span style="display:none">隐藏内容</span></div>const info = document.querySelector('#info');
console.log(info.textContent);
console.log(info.innerText);预期输出
可见内容隐藏内容
可见内容因此,innerText 适合需要模拟用户视觉读取的场景,例如复制页面显示内容,但它可能触发布局计算,频繁使用时性能开销更高。
使用 innerHTML 修改 HTML 结构
innerHTML 会把字符串解析为 HTML,并替换元素内部结构。
例如动态生成列表:
const list = document.querySelector('#list');
list.innerHTML = '<li>JavaScript</li><li>DOM</li>';预期结果
页面中的 list 元素新增两个 li 子元素。相比 textContent,innerHTML 能创建复杂结构,但输入内容不可信时存在安全风险。如果内容来自用户输入,直接拼接到 innerHTML 可能导致跨站脚本攻击(XSS)。
三种内容属性的选择
| 属性 | 处理方式 | 适用场景 |
|---|---|---|
textContent |
纯文本,不解析标签 | 修改文字、提示信息 |
innerText |
用户可见文本 | 获取页面实际显示内容 |
innerHTML |
解析 HTML 结构 | 动态生成可信 HTML |
实际开发中,可以优先使用 textContent。只有明确需要插入 HTML 结构,并且内容来源可信时,再考虑 innerHTML。
避免内容修改中的安全问题
用户输入通常应该作为文本处理,而不是直接插入 HTML。
const input = '<img src=x onerror=alert(1)>';
const output = document.querySelector('#output');
output.textContent = input;预期结果
页面显示原始字符串,不会执行其中的脚本。如果业务确实需要渲染用户提供的 HTML,应先经过可靠的 HTML 清理流程,再写入页面。
选择内容修改 API 时,可以先问自己一个问题:需要改变的是文字,还是页面结构?只改变文字时使用 textContent,需要生成结构时再谨慎使用 innerHTML。