XML DOM surroundContents() Methode
Definition und Verwendung
Die Methode surroundContents() umschließt den Inhalt des Bereichs mit dem angegebenen Knoten.
Syntax:
surroundContents(newParent)
Parameter
| Parameter | Beschreibung |
|---|---|
| newParent | wird der Knoten sein, der zum neuen Vaterknoten des Inhalts des aktuellen Bereichs wird. |
wird geworfen
Diese Methode wirft in folgenden Fällen eine Ausnahme mit folgendem Code DOMException-Ausnahmeoder RangeException-Ausnahme:
DOMException.HIERARCHY_REQUEST_ERR
der umschließende Knoten des Anfangspunkts des aktuellen Bereichs darf keine Unter-knoten haben, darf keine newParent der Unter-knoten eines Typs oder newParent Ist der Vorfahrer eines umschließenden Knotens.
DOMException.NO_MODIFICATION_ALLOWED_ERR
der Vorfahrenknoten der aktuellen Bereichsgrenzen ist schreibgeschützt und es sind keine Einfügungsoperationen erlaubt.
DOMException.WRONG_DOCUMENT_ERR
newParent und sein Bereich wurde mit einem anderen Document-Objekt erstellt.
RangeException.BAD_BOUNDARYPOINTS_ERR
der aktuelle Bereich wählt einen Teil eines Knotens aus (außer Text-Knoten), daher kann dieser Bereich des Dokuments nicht umschlossen werden.
RangeException.INVALID_NODE_TYPE_ERR
newParent sind Document-, DocumentFragment-, DocumentType-, Attr-, Entity- oder Notation-Knoten.
Beschreibung
dieser Methode wird den aktuellen übergeordneten Knoten des aktuellen Bereichs neu zugewiesen newParent, und dann newParent in den Anfangspunkt eines Bereichs im Dokument eingefügt werden kann, z.B., um einen Bereich eines Dokuments in ein <div>- oder <span>-Element zu setzen, kann diese Methode verwendet werden.
Wenn newParent wenn es bereits ein Teil des Dokuments ist, wird es zunächst aus dem Dokument entfernt und seine Kindknoten werden verworfen. Wenn dieser Methode zurückgekehrt wird, wird der Bereich mit newParent Der vorangehende Ort ist der Startpunkt,newParent Der nachfolgende Ort ist der Endpunkt.
