Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

element.textContent

Résumé

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

Syntaxe

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

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>

Description

  • 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.

Différences avec innerText

Internet Explorer a introduit la propriété innerText au comportement légèrement différent :

  • textContent récupère le contenu de tous les éléments, y compris <script> et <style>, ce qui n'est pas le cas de innerText.
  • innerText prend en compte le style de l'élément et ne retournera rien pour les éléments cachés. Aussi, il déclenchera un reflow à l'inverse de textContent.

Compatibilité navigateur

Caractéristique Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support de base 1+ (Oui) 9 (Oui) (Oui)
Caractéristique Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support de base ? ? ? ? ?

Spécification

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : fscholz, teoli, Etienne_WATTEBLED, khalid32, Delapouite, BenoitL
 Dernière mise à jour par : Etienne_WATTEBLED,