在此页

• 句法
• 描述
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

textContent 特性为 节点 interface represents the text content of the node and its descendants.

注意： textContent and HTMLElement.innerText are easily confused, but the two properties are different in important ways .

句法

let text = someNode.textContent
someOtherNode.textContent = string
					

值

A string or null

描述

值 textContent depends on the situation:

• 若节点是 document 或 Doctype , textContent 返回 null . 注意： To get all of the text and CDATA data for the whole document, one could use document.documentElement .textContent .
• 若节点是 CDATA section , comment, processing instruction ，或 text node , textContent returns the text inside the node, i.e., the Node.nodeValue .
• For other node types, textContent returns the concatenation of the textContent of every child node, excluding comments and processing instructions. (This is an empty string if the node has no children.)

设置 textContent on a node removes all of the node's children and replaces them with a single text node with the given string value.

Differences from innerText

Don't get confused by the differences between Node.textContent and HTMLElement.innerText . Although the names seem similar, there are important differences:

• textContent gets the content of all elements, including <script> and <style> elements. In contrast, innerText only shows “human-readable” elements.
• textContent returns every element in the node. In contrast, innerText is aware of styling and won’t return the text of “hidden” elements.
  • Moreover, since innerText takes CSS styles into account, reading the value of innerText triggers a reflow to ensure up-to-date computed styles. (Reflows can be computationally expensive, and thus should be avoided when possible.)
• 不像 textContent , altering innerText in Internet Explorer (version 11 and below) removes child nodes from the element and permanently destroys all descendant text nodes. It is impossible to insert the nodes again into any other element or into the same element after doing so.

Differences from innerHTML

Element.innerHTML returns HTML, as its name indicates. Sometimes people use innerHTML to retrieve or write text inside an element, but textContent has better performance because its value is not parsed as HTML.

Moreover, using textContent can prevent XSS attacks .

范例

Given this HTML fragment:

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

... you can use textContent to get the element's text content:

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

... or set the element's text content:

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

规范

规范	状态	注释
DOM The definition of 'Node.textContent' in that specification.	实时标准

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
textContent	Chrome 1	Edge 12	Firefox 1	IE 9	Opera 9	Safari 3	WebView Android 1	Chrome Android 18	Firefox Android 4	Opera Android 10.1	Safari iOS 1	Samsung Internet Android 1.0

图例

完整支持

完整支持

另请参阅

• HTMLElement.innerText
• Element.innerHTML
• More on differences between innerText and textContent (blog post)

元数据

• 最后修改： Jun 1, 2020

相关话题

1. DOM (文档对象模型)
2. 节点
3. 特性

   1. baseURI
   2. baseURIObject
   3. childNodes
   4. firstChild
   5. isConnected
   6. lastChild
   7. localName
   8. namespaceURI
   9. nextSibling
   10. nodeName
   11. nodePrincipal
   12. nodeType
   13. nodeValue
   14. outerText
   15. ownerDocument
   16. parentElement
   17. parentNode
   18. prefix
   19. previousSibling
   20. rootNode
   21. textContent
4. 方法

   1. appendChild()
   2. cloneNode()
   3. compareDocumentPosition()
   4. contains()
   5. getRootNode()
   6. getUserData()
   7. hasChildNodes()
   8. insertBefore()
   9. isDefaultNamespace()
   10. isEqualNode()
   11. isSameNode()
   12. isSupported()
   13. lookupNamespaceURI()
   14. lookupPrefix()
   15. normalize()
   16. removeChild()
   17. replaceChild()
   18. setUserData()
5. 继承：

   1. EventTarget
6. DOM 相关页面

   1. AbortController
   2. AbortSignal
   3. AbstractRange
   4. Attr
   5. ByteString
   6. CDATASection
   7. CSSPrimitiveValue
   8. CSSValue
   9. CSSValueList
   10. CharacterData
   11. ChildNode
   12. 注释
   13. CustomEvent
   14. DOMConfiguration
   15. DOMError
   16. DOMErrorHandler
   17. DOMException
   18. DOMImplementation
   19. DOMImplementationList
   20. DOMImplementationRegistry
   21. DOMImplementationSource
   22. DOMLocator
   23. DOMObject
   24. DOMParser
   25. DOMPoint
   26. DOMPointInit
   27. DOMPointReadOnly
   28. DOMRect
   29. DOMString
   30. DOMTimeStamp
   31. DOMTokenList
   32. DOMUserData
   33. Document
   34. DocumentFragment
   35. DocumentType
   36. 元素
   37. ElementTraversal
   38. Entity
   39. EntityReference
   40. 事件
   41. EventTarget
   42. HTMLCollection
   43. MutationObserver
   44. NodeFilter
   45. NodeIterator
   46. NodeList
   47. NonDocumentTypeChildNode
   48. ProcessingInstruction
   49. PromiseResolver
   50. 范围
   51. StaticRange
   52. 文本
   53. TextDecoder
   54. TextEncoder
   55. TimeRanges
   56. TreeWalker
   57. TypeInfo
   58. USVString
   59. UserDataHandler
   60. XMLDocument