Free Trial

Safari Books Online is a digital library providing on-demand subscription access to thousands of learning resources.


  • Create BookmarkCreate Bookmark
  • Create Note or TagCreate Note or Tag
  • DownloadDownload
  • PrintPrint
Share this Page URL
Help

Referenz für clientseitiges JavaScript > Range.surroundContents( )

Range.surroundContents( )Umgibt den Bereichsinhalt mit dem angegebenen Knoten

Überblick

void surroundContents(Node neuerVorfahr)
  throws RangeException, DOMException;

Argumente


neuerVorfahr

Der Knoten, der der neue Elternknoten für den Inhalt dieses Bereichs werden soll.

Exceptions

Diese Methode löst unter folgenden Umständen eine DOMException oder RangeException mit einem der folgenden code-Werte aus:


DOMException.HIERARCHY_REQUEST_ERR

Der Container-Knoten des Bereichsanfangs erlaubt entweder gar keine Kinder, oder er erlaubt keine Kinder des Typs von neuerVorfahr, oder neuerVorfahr ist ein Vorfahr dieses Container-Knotens.


DOMException.NO_MODIFICATION_ALLOWED_ERR

Ein Vorfahr eines Grenzpunkts des Bereichs ist schreibgeschützt und gestattet keine Einfügungen.


DOMException.WRONG_DOCUMENT_ERR

neuerVorfahr und dieser Bereich wurden mit verschiedenen Document-Objekten erzeugt.


RangeException.BAD_BOUNDARYPOINTS_ERR

Der Bereich markiert teilweise einen Knoten (der kein Text-Knoten ist), sodass der Dokumentteil, den er repräsentiert, nicht umgeben werden kann.


RangeException.INVALID_NODE_TYPE_ERR

neuerVorfahr ist ein Document-, DocumentFragment-, DocumentType-, Attr-, Entity- oder Notation-Knoten.

Beschreibung

Diese Methode gibt dem Inhalt dieses Bereichs neuerVorfahr zum Elternteil und fügt dann neuerVorfahr am Anfangspunkt des Bereichs in das Dokument ein. Sie ist nützlich, um einen Teil des Dokumentinhalts z.B. in ein <div>- oder <span>-Element zu setzen.

Ist neuerVorfahr bereits Teil des Dokuments, so wird er zuerst daraus entfernt, und eventuell vorhandene Kinder werden verworfen. Wenn diese Methode zurückkehrt, beginnt dieser Bereich unmittelbar vor neuerVorfahr und endet unmittelbar dahinter.