HTML textContent的使用

发布日期: 2021-12-01

更新日期: 2026-04-15

文章字数: 842

阅读时长: 3 分

阅读次数:

Node接口的 textContent 属性表示一个节点及其后代的文本内容。

返回值

一个字符串或 null。

描述

textContent 的值取决于具体情况：

如果节点是一个 document，或者一个DOCTYPE，则textContent返回null。
如果节点是个CDATA section、注释、processing instruction (en-US)或者text node，textContent返回节点内部的文本内容，例如Node.nodeValue。
对于其他节点类型，textContent 将所有子节点的textContent合并后返回，除了注释和processing instructions。（如果该节点没有子节点的话，返回一个空字符串。）

在节点上设置 textContent 属性的话，会删除它的所有子节点，并替换为一个具有给定值的文本节点。

与 innerText 的区别

不要被 Node.textContent和HTMLElement.innerText的区别搞混了。虽然名字看起来很相似，但有重要的不同之处：

textContent会获取所有元素的内容，包括<script>和<style>元素，然而innerText只展示给人看的元素。
textContent 会返回节点中的每一个元素。相反，innerText 受 CSS 样式的影响，并且不会返回隐藏元素的文本
- 此外，由于innerText受CSS样式的影响，它会触发回流（reflow）去确保是最新的计算样式。（回流在计算上可能会非常昂贵，因此应尽可能避免。）
与textContent不同的是, 在 Internet Explorer (小于和等于 11 的版本) 中对innerText进行修改，不仅会移除当前元素的子节点，而且还会永久性地破坏所有后代文本节点。在之后不可能再次将节点再次插入到任何其他元素或同一元素中。

例子：

<h3>Source element:</h3>
<p id="source">
    <style>
        #source {
            color: red;
        }
        textarea {
            width: auto;
            height: auto;
        }
    </style>
    Take a look at<br />how this text<br />is interpreted below.
    <span style="display:none">HIDDEN TEXT</span>
</p>
<h3>Result of textContent:</h3>
<textarea id="textContentOutput" rows="6" cols="50" readonly></textarea>
<h3>Result of innerText:</h3>
<textarea id="innerTextOutput" rows="6" cols="50" readonly></textarea>
<script>
    const source = document.getElementById("source");
    const textContentOutput = document.getElementById("textContentOutput");
    const innerTextOutput = document.getElementById("innerTextOutput");
    textContentOutput.innerHTML = source.textContent;
    innerTextOutput.innerHTML = source.innerText;
</script>

结果：

Source element:

Take a look at
how this text
is interpreted below. HIDDEN TEXT

Result of textContent:

Result of innerText:

与 innerHTML 的区别

正如其名称，Element.innerHTML返回 HTML。通常，为了在元素中检索或写入文本，人们使用innerHTML。但是，textContent通常具有更好的性能，因为文本不会被解析为HTML。

此外，使用textContent可以防止XSS 攻击。

例子：

给出这个 HTML 片段:

<div id="divA">This is <span>some</span> text!</div>

你可以使用 textContent 去获取该元素的文本内容：

let text = document.getElementById("divA").textContent;
// The text variable is now: 'This is some text!'

或者设置元素的文字内容：

document.getElementById("divA").textContent = "This text is different!";
// The HTML for divA is now:
// <div id="divA">This text is different!</div>

IE8 的替代方法

// Source: Eli Grey @ https://eligrey.com/blog/post/textcontent-in-ie8
if (
    Object.defineProperty &&
    Object.getOwnPropertyDescriptor &&
    Object.getOwnPropertyDescriptor(Element.prototype, "textContent") &&
    !Object.getOwnPropertyDescriptor(Element.prototype, "textContent").get
) {
    (function () {
        var innerText = Object.getOwnPropertyDescriptor(Element.prototype, "innerText");
        Object.defineProperty(
            Element.prototype,
            "textContent",
            // Passing innerText or innerText.get directly does not work,
            // wrapper function is required.
            {
                get: function () {
                    return innerText.get.call(this);
                },
                set: function (s) {
                    return innerText.set.call(this, s);
                },
            }
        );
    })();
}