DOM:element.textContent

Un article de MDC.

« Référence du DOM Gecko

Sommaire 1 Résumé 2 Syntaxe 3 Exemple 4 Notes 5 Spécification

[modifier] Résumé

Définit ou obtient le contenu textuel d'un nœud et de ses descendants.

[modifier] Syntaxe

texte = element.textContent;
element.textContent = "un exemple de texte";

[modifier] Exemple

// Étant donné le fragment de HTML suivant :
//   <div id="divA">Ceci est un <span>exemple de</span> texte</div>

// On obtient le contenu textuel :
var text = document.getElementById("divA").textContent;
// |text| vaut "Ceci est un exemple de texte".

// On définit le contenu textuel :
document.getElementById("divA").textContent = "Ceci est un exemple de texte";
// Le HTML pour divA est à présent <div id="divA">Ceci est un exemple de texte</div>

[modifier] Notes

• textContent renvoie null si l'élément est un document, un type de document (doctype) ou une notation.
• Si le nœud est une section CDATA, un commentaire, une instruction de traitement ou un nœud texte, textContent renvoie le texte à l'intérieur du nœud (la valeur nodeValue).
• Pour les autres types de nœuds, textContent renvoie la concaténation des attributs textContent de chaque nœud enfant, à l'exception des commentaires et nœuds d'instructions de traitement. Si le nœud n'a pas d'enfants, il s'agira d'une chaîne vide.
• En définissant cette propriété sur un nœud, on enlève tous ses enfants et ceux-ci sont remplacés par un seul nœud texte avec la valeur donnée.

[modifier] Spécification

• DOM Level 3 Core: textContent