Text

(Auszug aus "XML in a Nutshell" von Elliotte Rusty Harold & W. Scott Means)

Text-Knoten enthalten die eigentlichen Textdaten des XML-Dokuments. Damit unterscheiden sie sich klar von Markup. Nachdem das XML-Dokument vom Parser gelesen wurde, verbleibt für jeden zusammenhängenden Textbereich genau ein Text-Knoten.

 


Attribute

Das Interface Text definiert die folgenden Attribute:

 


wholeText: DOMString (3)

Das ist ein der Bequemlichkeit dienendes Attribut, das in Dokumentreihenfolge den ganzen Text des Zielknotens sowie den Text angrenzender Text-Knoten liefert. Für die Zwecke dieses Attributs werden Text-Knoten als angrenzend betrachtet, wenn sie ohne Eintreten, Verlassen oder Überspringen eines der folgenden Knotentypen erreicht werden können: Element, Comment und ProcessingInstruction. Nur-lesbar.

Java-Bindung
public String getWholeText( );

 


isElementContentWhitespace: boolean (3)

Liefert true, wenn das Element nur Whitespace enthält, für den bei der XML-Validierung festgestellt wurde, dass er keine Bedeutung hat. Whitespace hat keine Bedeutung, wenn er nicht zu einem Element gehört, dessen Deklaration sagt, dass es Textinhalt oder gemischte Inhalte enthält. Nur-lesbar.

Java-Bindung
public boolean isElementContentWhitespace( );

 


Methoden

Für das Interface Text sind die folgenden Methoden definiert:

 


replaceWholeText: content (3)

Das ist eine der Bequemlichkeit dienende Methode, mit der mehrere aneinander grenzende Textknoten durch einen einzigen Textknoten ersetzt werden können, der den Text enthält, der mit dem Argument content übergeben wird. Die Methode liefert eine Referenz auf den Text-Knoten, der den neuen Inhalt erhalten hat, oder null, wenn content einen String der Länge null enthielt.

Argument

  • content: DOMString

    Der neue Textinhalt, der für die Ersetzung verwendet werden soll.

Exceptions

  • NO_MODIFICATION_ALLOWED_ERR

    Wird ausgelöst, wenn das Element nur-lesbar ist.

 


splitText: offset

Der Text-Knoten wird in zwei aufeinander folgende Text-Knoten aufgespalten. Der Inhalt des ursprünglichen Knotens wird in zwei Substrings aufgeteilt. Der zweite Substring wird als Wert des neuen Knotens genommen, der erste verbleibt im Ausgangsknoten. Falls der Knoten aktuell in den DOM-Baum eingebunden ist, wird der neue Knoten mit dem abgespaltenen Inhalt zum nachfolgenden Geschwisterknoten des originalen Knotens. Das Ergebnis der Methode ist der neue Text-Knoten, der den zweiten Teil der Textdaten enthält.

Argument

  • offset (unsigned long)

    Position, an der der Inhalt zu spalten ist, beginnend bei 0.

Exceptions

  • INDEX_SIZE_ERR

    Der übergebene Offset war ungültig, es muss 0 <= offset <= length gelten.

  • NO_MODIFICATION_ALLOWED_ERR

    Wird ausgelöst, wenn das Element nur-lesbar ist.

Java-Bindung
public Text splitText(long offset) throws DOMException;

Java-Beispiel

// Erzeuge einen Textknoten
long = doc.createTextNode("Dieser Text wird geteilt.");

// und teile ihn in zwei Knoten auf.
Text ndSplit = ndText.splitText(9);

Anmerkung: Das Interface Text ist vom Interface CharacterData abgeleitet. Lesen Sie dazu auch die Hinweise zum Interface CharacterData. Dort erhalten Sie eine vollständige Übersicht über die Methoden zum Zugriff auf Zeichendaten in Knoten von diesem Typ.

  

<< zurück vor >>

 

 

 

Tipp der data2type-Redaktion:
Zum Thema XML bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an:

  


Copyright © 2005 O'Reilly Verlag GmbH & Co. KG
Für Ihren privaten Gebrauch dürfen Sie die Online-Version ausdrucken.
Ansonsten unterliegt dieses Kapitel aus dem Buch "XML in a Nutshell" denselben Bestimmungen, wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.

O’Reilly Verlag GmbH & Co. KG, Balthasarstraße 81, 50670 Köln, kommentar(at)oreilly.de