Metoda XML DOM insertNode()
Definicja i użycie
Metoda insertNode() wstawia węzeł na początku zakresu.
Gramatyka:
insertNode(newNode)
Parametr
| Parametr | Opis |
|---|---|
| newNode | Węzeł do wstawienia do dokumentu. |
Wywoła
Jeśli newNode Jest węzłem Attr, Document, Entity lub Notation, metoda ta wywoła wyjątek o kodzie INVALID_NODE_TYPE_ERR Wyjątek RangeException.
Pod następującymi warunkami, metoda ta również wywoła wyjątek DOMException z kodem:
- BŁĘD_WYMAGANIA_HIERARCHII - Węzeł początkowy zakresu nie może mieć podwęzłów, nie może również mieć podwęzłów określonego typu lub newNode Jest przodkiem tego węzła (lub jest tym węzłem samym).
- NO_MODIFICATION_ALLOWED_ERR - Węzeł zawierający początek zakresu (lub jego przodkowie) jest tylko do odczytu.
- WRONG_DOCUMENT_ERR - newNode Różni się od dokumentu, do którego należy zakres.
Opis
Ta metoda wstawi określony węzeł (i wszystkie jego potomki) w początkowy punkt zakresu dokumentu. Po zwróceniu się tej metody, bieżący zakres będzie obejmował nowo wstawione węzły. Jeśli newNode Już jest częścią dokumentu, zostanie on usunięty z bieżącej pozycji i ponownie wstawiony w początkowym punkcie zakresu. Jeśli newNode Jest Węzeł DocumentFragment, wstawiany nie jest sam węzeł, ale jego potomkowie, w kolejności wstawiania początkowego punktu zakresu.
Jeśli węzeł zawierający początek bieżącego zakresu jest węzłem Text, zostanie on podzielony na dwa sąsiednie węzły przed wykonaniem operacji wstawienia. Jeśli newNode Jest węzłem Text, po wstawieniu do dokumentu, nie łączy się z żadnym sąsiednim węzłem Text. Aby połączyć sąsiednie węzły, należy wywołać Node.normalize() Metoda.
