HTMLElement : propriété outerText
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis mars 2022.
La propriété outerText de l'interface HTMLElement retourne la même valeur que HTMLElement.innerText.
Utilisée en écriture, elle remplace tout le nœud courant par le texte donné (ce qui diffère de innerText, qui remplace le contenu à l'intérieur du nœud courant).
Voir HTMLElement.innerText pour plus d'informations et des exemples montrant comment les deux propriétés sont utilisées comme accesseurs.
Valeur
Une chaîne de caractères représentant le contenu textuel affiché d'un élément et de ses descendants.
Si l'élément lui-même n'est pas affiché (angl.) (par exemple, s'il est détaché du document ou caché à la vue), la valeur retournée est la même que celle de la propriété Node.textContent.
Utilisée en écriture, elle remplace le nœud courant par le texte donné, en convertissant les sauts de ligne en éléments HTML <br>.
Exemples
Cet exemple met en évidence la différence fondamentale entre outerText et innerText lorsqu'ils sont utilisés comme mutateurs (ils sont identiques en tant qu'accesseurs).
Note : Cet exemple est une version modifiée de Quelle est la différence entre innerText et outerText ? (angl.) (Stack Overflow) par codingintrigue (angl.), sous licence CC BY-SA 3.0 (angl.).
Considérez une page contenant le HTML suivant :
<div>
<p>Contenu original</p>
</div>
outerText remplace tout l'élément sélectionné, donc le JavaScript p.outerText = "Tout l'élément est remplacé" remplace tout l'élément p sélectionné :
<div>Tout l'élément est remplacé</div>
À l'inverse, p.innerText = "Contenu interne de l'élément remplacé" remplace le contenu interne de l'élément p sélectionné :
<div>
<p>Contenu interne de l'élément remplacé</p>
</div>
Spécification
| Specification |
|---|
| HTML # dom-outertext |
Compatibilité des navigateurs
Voir aussi
- La propriété
HTMLElement.innerText - La propriété
Element.outerHTML