mozilla
Your Search Results

    Node.textContent

    This translation is incomplete. Please help translate this article from English.

    The Node.textContent property represents the text content of a node and its descendants.

    Syntax

    var text = element.textContent;
    element.textContent = "this is some sample text";
    

    Description

    • textContent returns null if the element is a document, a document type, or a notation. To grab all of the text and CDATA data for the whole document, one could use document.documentElement.textContent.
    • If the node is a CDATA section, a comment, a processing instruction, or a text node, textContent returns the text inside this node (the nodeValue).
    • For other node types, textContent returns the concatenation of the textContent attribute value of every child node, excluding comments and processing instruction nodes. This is an empty string if the node has no children.
    • Setting this property on a node removes all of its children and replaces them with a single text node with the given value.

    Differences from innerText

    Internet Explorer introduced element.innerText. The intention is similar but with the following differences:

    • While textContent gets the content of all elements, including <script> and <style> elements, the IE-specific property innerText does not.
    • innerText is aware of style and will not return the text of hidden elements, whereas textContent will.
    • As innerText is aware of CSS styling, it will trigger a reflow, whereas textContent will not.

    Differences from innerHTML

    innerHTML returns the HTML as its name indicates. Quite often, in order to retrieve or write text within an element, people use innerHTML. textContent should be used instead. Because the text is not parsed as HTML, it's likely to have better performance. Moreover, this avoids an XSS attack vector.

    Example

    // Given the following HTML fragment:
    //   
    This is some text

    // Get the text content: var text = document.getElementById("divA").textContent; // |text| is set to "This is some text". // Set the text content: document.getElementById("divA").textContent = "This is some text"; // The HTML for divA is now: //

    This is some text

    Browser compatibility

    Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
    Basic support 1+ (Ja) 9 (Ja) (Ja)
    Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
    Basic support ? ? ? ? ?

    Specification

    Document Tags and Contributors

    Contributors to this page: fscholz, wepunkt_empunkt
    Last updated by: fscholz,