XML DOM insertNode() metode
Definition og brug
insertNode() metoden indsætter en knude i begyndelsen af en række.
Syntaks:
insertNode(newNode)
Parameter
| Parameter | beskrivelse |
|---|---|
| newNode | knuder, der skal indsættes i dokumentet. |
udløses
hvis newNode er en Attr-, Document-, Entity- eller Notation-knude, vil metoden kaste en fejl med koden INVALID_NODE_TYPE_ERR RangeException-fejl.
Under følgende betingelser vil metoden også kaste en DOMException-fejl med følgende kode:
- HIERARCHY_REQUEST_ERR - En knude, der indeholder startpunktet for en række, kan ikke have underknuder, og den kan heller ikke have underknuder af specificeret type, eller newNode er en ancestor node til denne node (eller denne node selv).
- NO_MODIFICATION_ALLOWED_ERR - Node, der indeholder begyndelsen af området (eller dens aner), er skrivebeskyttet.
- WRONG_DOCUMENT_ERR - newNode er forskellig fra dokumentet, som området tilhører.
beskrivelse
Denne metode vil indsætte den specificerede node (og alle dens efterkommere) ved begyndelsen af dokumentområdet. Når denne metode returnerer, vil den aktuelle område inkludere de nyindsatte nodeer. Hvis newNode allerede en del af dokumentet, vil den blive fjernet fra den nuværende position og derefter genindsat ved begyndelsen af området. Hvis newNode er DocumentFragment node, så indsættes det ikke selv, men dens efterkommere, i rækkefølgen af den begyndende punkt i området.
hvis indeholdende node for begyndelsen af den aktuelle område er en Text node, vil den blive delt i to nærliggende nodeer før indsættelsesoperationen. Hvis newNode er en Text node, og når den indsættes i dokumentet, vil den ikke blive slået sammen med nogen nærliggende Text node. For at slå sammen nærliggende nodeer, skal du kalde Node.normalize() metoder.
