轻松上手,快乐学习!

HTML DOM textContent 属性


实例

获取元素的文本内容:

var x = document.getElementById("myBtn").textContent;
亲自试一试 »

页面下方有更多实例。


定义和用法

textContent 属性设置或返回指定节点及其所有子节点的文本内容。

如果设置 textContent 属性,所有子节点都将被删除,并替换为包含指定字符串的单个文本节点。

注释: 此属性与 innerText 属性类似,但有一些区别:

  • textContent 返回所有元素的文本内容,而innerText返回所有元素的内容,除了<script> 和 <style>元素。
  • innerText不会返回使用CSS隐藏的元素的文本(textContent将返回)。 试一试 »

提示: 有时可以使用此属性代替 nodeValue 属性,但请记住,此属性也会返回所有子节点的文本。

提示: 要设置或返回元素的HTML内容,请使用 innerHTML 属性。


浏览器支持

表中的数字表示支持该属性的第一个浏览器版本。

属性
textContent 1.0 9.0 Yes Yes Yes

语法

返回节点的文本内容:

node.textContent

设置节点的文本内容:

node.textContent = text

属性值

类型 描述
text String 指定节点的文本内容

技术细节

返回值: 一个字符串,表示节点及其所有子节点的文本。
如果元素是文档、文档类型或符号,则返回 null
DOM 版本 Core Level 3 Node Object

更多实例

实例

更改 id="demo" 的<p>元素的文本内容:

document.getElementById("demo").textContent = "Paragraph changed!";
亲自试一试 »

实例

获取 id="myList" 的 <ul> 元素的所有文本内容:

var x = document.getElementById("myList").textContent;

x 的值为:

Coffee Tea
亲自试一试 »

实例

此示例演示innerText、innerHTML 和 textContent之间的一些差异:

<p id="demo">   This element has extra spacing     and contains <span>a span element</span>.</p>

<script>
function getInnerText() {
  alert(document.getElementById("demo").innerText)
}

function getHTML() {
  alert(document.getElementById("demo").innerHTML)
}

function getTextContent() {
  alert(document.getElementById("demo").textContent)
}
</script>
亲自试一试 »

使用指定的属性获取上面 <p> 元素的内容:

innerText 返回: "这个元素有额外的间距,并且包含一个span元素。"
innerHTML 返回: "   这个元素有额外的间距,并且包含 <span>一个span元素</span>."
textContent 返回: "   这个元素有额外的间距,并且包含一个span元素。"

innerText 属性只返回文本,没有间距和内部元素标记。

innerHTML 属性返回文本,包括所有间距和内部元素标记。

textContent 属性返回带间距但不带内部元素标记的文本。