Safari Books Online is a digital library providing on-demand subscription access to thousands of learning resources.
| Range.surroundContents( ) | Umgibt den Bereichsinhalt mit dem angegebenen Knoten |
void surroundContents(Node neuerVorfahr) throws RangeException, DOMException;
neuerVorfahr
Der Knoten, der der neue Elternknoten für den Inhalt dieses Bereichs werden soll.
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.
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.