XML DOM insertNode() method
Definition and Usage
The insertNode() method inserts a node at the beginning of the range.
Syntax:
insertNode(newNode)
parameter
| parameter | beskrivning |
|---|---|
| newNode | the node to be inserted into the document. |
throw
if newNode is an Attr, Document, Entity, or Notation node, the method will throw an INVALID_NODE_TYPE_ERR code RangeException exception.
Under the following conditions, the method will also throw the following DOMException exception:
- HIERARCHY_REQUEST_ERR - The starting point of the range cannot have child nodes, nor can it have child nodes of a specified type, or newNode är en av dess anfäder (eller det är noden själv).
- NO_MODIFICATION_ALLOWED_ERR - Noden som innehåller början av riktlinjen (eller en av dess anfäder) är skrivskyddad.
- WRONG_DOCUMENT_ERR - newNode är annorlunda från dokumentet som riktlinjen tillhör.
beskrivning
Denna metod kommer att infoga den specificerade noden (och alla dess avkommanden) vid början av dokumentets riktlinje. När denna metod returnerar kommer den aktuella riktlinjen att inkludera de nyligen infogade noderna. Om newNode redan en del av dokumentet, kommer det att tas bort från den nuvarande positionen och sedan återinfogas vid riktlinjens början. Om newNode är DocumentFragment-knot, så är det inte det själv som läggs in, utan dess avkommanden, i följdordning infoga riktlinjens början.
om innehållet i den aktuella riktlinjen är en Text-knot, kommer det att delas upp i två närliggande noder innan infogningen sker. Om newNode är en Text-knot, efter att ha infogats i dokumentet, kommer det inte att klistras ihop med några närliggande Text-knot. För att klistra ihop närliggande noder, måste du anropa Node.normalize() metoder.
