Metoda XML DOM surroundContents()
Definicja i użycie
Metoda surroundContents() używa określonego węzła do otaczania zawartości zakresu.
Gramatyka:
surroundContents(newParent)
Parametr
| Parametr | Opis |
|---|---|
| newParent | Będzie to węzeł, który zostanie nowym rodzicem zawartości bieżącego zakresu. |
Wyrzuca
Ta metoda wyrzuci wyjątek z takim kodem w następujących przypadkach: Wyjątek DOMExceptionlub Wyjątek RangeException:
DOMException.HIERARCHY_REQUEST_ERR
węzeł wchłaniający początku obecnego zakresu nie może mieć podwęzłów, nie może mieć newParent podwęzła tego typu, lub newParent Jest przodkiem węzła wchłaniającego.
DOMException.NO_MODIFICATION_ALLOWED_ERR
Przodkowie bieżących punktów granicznych zakresu są tylko do odczytu, operacje wstawiania nie są dozwolone.
DOMException.WRONG_DOCUMENT_ERR
newParent i jego zakres jest utworzony za pomocą różnych obiektów Document.
RangeException.BAD_BOUNDARYPOINTS_ERR
Bieżący zakres wybiera w części节点（oprócz węzłów Text），więc nie można otoczyć tego obszaru dokumentu.
RangeException.INVALID_NODE_TYPE_ERR
newParent jest węzłem Document, DocumentFragment, DocumentType, Attr, Entity lub Notation.
Opis
Ta metoda ustali jako nowego rodzica bieżącego węzła zakresu newParent, a następnie umieść newParent wstawiony w początkowym miejscu zakresu dokumentu. Na przykład, aby umieścić obszar dokumentu w elemencie <div> lub <span>, można użyć tej metody.
Jeśli newParent Jest już częścią dokumentu, więc najpierw zostanie usunięty z dokumentu, a jego podnode również będą pomijane. Gdy ten metodę zwróci, zakres będzie miał newParent Pozycja przed którą następuje jest punktem początkowym,newParent Pozycja po której następuje jest punktem końcowym.
