Text: wholeText-Eigenschaft
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Die schreibgeschützte wholeText-Eigenschaft der Text-Schnittstelle
gibt den gesamten Text aller Text-Knoten zurück, die logisch an den Knoten angrenzen.
Der Text wird in Dokument-Reihenfolge verkettet.
Dies ermöglicht es, einen beliebigen Textknoten anzugeben und den gesamten angrenzenden Text als eine einzelne Zeichenkette zu erhalten.
Hinweis:
Dies ist ähnlich dem Aufruf von Node.normalize(), gefolgt vom Lesen des Textwertes,
jedoch ohne den Baum zu verändern.
Wert
Eine Zeichenkette mit dem verketteten Text.
Beispiel
Angenommen, Sie haben folgenden einfachen Absatz auf Ihrer Webseite:
<p>
Through-hiking is great!
<strong>No insipid election coverage!</strong> However,
<a href="https://en.wikipedia.org/wiki/Absentee_ballot">casting a ballot</a>
is tricky.
</p>
Sie entscheiden sich, den mittleren Satz nicht mehr zu mögen, also entfernen Sie ihn:
const paragraph = document.querySelector("p"); // Reads the paragraph
paragraph.removeChild(paragraph.childNodes[1]); // Delete the strong element
Nun endet der Text mit "Through-hiking is great! However, casting a ballot is tricky.", mit zwei Knoten vor dem Hyperlink:
- Ein
Text, der die Zeichenkette"Through-hiking is great!"enthält. - Ein zweiter
Text-Knoten, der die Zeichenkette" However, "enthält.
Um diese beiden Knoten auf einmal zu erhalten, würden Sie paragraph.childNodes[0].wholeText aufrufen:
console.log(`'${paragraph.childNodes[0].wholeText}'`); // 'Through-hiking is great! However, '
Spezifikationen
| Specification |
|---|
| DOM # ref-for-dom-text-wholetext① |
Browser-Kompatibilität
Loading…
Siehe auch
- Die
Text-Schnittstelle, zu der es gehört.