XML DOM insertNode() 方法
定义和用法
insertNode() 方法在范围的开头插入一个节点。
语法:
insertNode(newNode)
参数
参数 | kuvaus |
---|---|
newNode | 要插入文档的节点。 |
抛出
如果 newNode 是 Attr、Document、Entity 或 Notation 节点,该方法将抛出代码为 INVALID_NODE_TYPE_ERR 的 RangeException 异常.
在下列条件下,该方法还将抛出如下代码的 DOMException 异常:
- HIERARCHY_REQUEST_ERR - 包含范围的开始点的节点不能有子节点,它也不能有指定类型的子节点,或者 newNode on tämän solmun isäntäsolmu (tai tämä solmu itse).
- NO_MODIFICATION_ALLOWED_ERR - Alueen alkupisteessä oleva solmu (tai sen isäntäsolmu) on lukuun ottamatta.
- WRONG_DOCUMENT_ERR - newNode on eri kuin alueeseen kuuluva dokumentti.
kuvaus
Tämä menetelmä lisää määritetyn solmun (ja sen kaikki jälkeläissolmut) dokumentin alueen alkupisteeseen. Kun tämä menetelmä palauttaa, nykyinen alue sisältää uudelleen lisätyt solmut. Jos newNode on jo dokumentin osa, se poistetaan nykyisestä sijainnistaan ja lisätään uudelleen alueen alkupisteeseen. Jos newNode on DocumentFragment-solmu, niin lisätään ei itse solmu, vaan sen jälkeläiset solmut, jotka lisätään järjestyksessä alueen alkupisteeseen.
Jos solmu, joka sisältää nykyisen alueen alkupisteen, on Text-solmu, se jaetaan kahteen lähelle sijoitettuun solmuun ennen lisäysoperatiota. Jos newNode On Text-solmu, kun se lisätään dokumenttiin, se ei yhdistetä mihinkään läheiseen Text-solmuun. Jos haluat yhdistää lähellä olevat solmut, sinun täytyy kutsua Node.normalize() menetelmät.