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 July 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:

html
<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:

js
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:

  1. Ein Text, der die Zeichenkette "Through-hiking is great!" enthält.
  2. 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:

js
console.log(`'${paragraph.childNodes[0].wholeText}'`); // 'Through-hiking is great!   However, '

Spezifikationen

Specification
DOM
# ref-for-dom-text-wholetext①

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
wholeText

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch

  • Die Text-Schnittstelle, zu der es gehört.