HTMLElement: outerText-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2022 browserübergreifend verfügbar.
Die outerText-Eigenschaft der HTMLElement-Schnittstelle liefert denselben Wert wie HTMLElement.innerText.
Wenn sie als Setter verwendet wird, ersetzt sie das gesamte aktuelle Element durch den angegebenen Text (dies unterscheidet sich von innerText, welches den Inhalt innerhalb des aktuellen Elements ersetzt).
Siehe HTMLElement.innerText für weitere Informationen und Beispiele, die zeigen, wie beide Eigenschaften als Getter verwendet werden.
Wert
Ein String, der den angezeigten Textinhalt eines Elements und seiner Nachkommen darstellt.
Wenn das Element selbst nicht gerendert wird (zum Beispiel, wenn es vom Dokument getrennt oder aus der Ansicht ausgeblendet ist), entspricht der zurückgegebene Wert der Node.textContent-Eigenschaft.
Wenn sie als Setter verwendet wird, ersetzt sie das aktuelle Element durch den angegebenen Text, wobei alle Zeilenumbrüche in <br>-Elemente umgewandelt werden.
Beispiele
Dieses Beispiel zeigt den grundlegenden Unterschied zwischen outerText und innerText, wenn sie als Setter verwendet werden (als Getter sind sie identisch).
Hinweis: Das Beispiel ist eine modifizierte Version von What is the difference between innerText and outerText? (Stack overflow) von codingintrigue, lizenziert unter CC BY-SA 3.0.
Betrachten Sie eine Seite, die das folgende HTML enthält:
<div>
<p>Original content</p>
</div>
outerText ersetzt das gesamte ausgewählte Element, sodass das JavaScript p.outerText = "Whole element replaced" das gesamte ausgewählte p-Element ersetzt:
<div>Whole element replaced</div>
Im Gegensatz dazu ersetzt p.innerText = "Content inside element replaced" den Inhalt innerhalb des ausgewählten p-Elements:
<div>
<p>Content inside element replaced</p>
</div>
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-outertext |