English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Propriedade textContent do HTML DOM

Objeto Elemento do HTML DOM

textContentAtributo define ou retorna o conteúdo de texto do nó especificado e todos os seus subnós.

Definir textContent no nó remove todos os subnós do nó e os substitui por um único nó de texto com o texto dado.

O atributo textContent é semelhante ainnerTextAtributo, mas há algumas diferenças:

  • textContent retornatodoso conteúdo de texto do elemento, enquanto innerText retornaexceto elementos <script> e <style>forade todos os elementos.

  • innerText não retorna o texto oculto no CSS (textContent o faz)

Para definir ou retornar o conteúdo HTML do elemento, useinnerHTMLAtributo.

Sintaxe:

Retorna o conteúdo de texto do nó:

node.textContent

Definir o conteúdo de texto do nó:

node.textContent = text
var x = document.getElementById("para").textContent;
Teste e Veja‹/›

Compatibilidade do navegador

Todos os navegadores suportam completamente o atributo textContent:

Atributo
textContentSimSimSimSimSim

Valor do atributo

ValorDescrição
textEspecificar o conteúdo de texto do nó especificado

Detalhes técnicos

Retorno:Uma string que representa o nó e todos os seus subnós. Se o elemento for um documento, tipo de documento ou símbolo, retorna null
Versão DOM:Nível DOM3

Mais exemplos

Mudar o conteúdo do texto do elemento <p> usando id="para":

var x = document.getElementById("para");
x.textContent = "HELLO WORLD";
Teste e Veja‹/›

Retorna todo o conteúdo de texto do elemento DIV:

var x = document.getElementById("container").textContent;
Teste e Veja‹/›

Este exemplo demonstra a diferença entre innerText, innerHTML e textContent:

<p id="x">Este elemento possui espaçamento adicional e contém um <span>span</span> elemento</span>.</p>
<script>
function getInnerText() {
alert(document.getElementById("x").innerText);
}
function getInnerHTML() {
alert(document.getElementById("x").innerHTML);
}
function getTextContent() {
alert(document.getElementById("x").textContent);
}
</script>
Teste e Veja‹/›

A propriedade innerText retorna apenas o texto, sem espaços e etiquetas internas de elementos.

A propriedade innerHTML retorna o texto com espaços e etiquetas internas de elementos.

A propriedade textContent retorna o texto com espaços, mas sem etiquetas internas de elementos.

Referências Relacionadas

Referência do HTML DOM:HTMLElementPropriedade .innerText

Referência do HTML DOM:elementoPropriedade .innerHTML

Objeto Elemento do HTML DOM