Μέθοδος insertNode() XML DOM

Ορισμός και χρήση

Η μέθοδος insertNode() εισάγει έναν κόμβο στην αρχή του διαστήματος.

Γλώσσα:

insertNode(newNode)

παράμετρο

παράμετρο Περιγραφή
newNode να εισάγουμε κόμβους στο έγγραφο.

προκαλέσει

Αν newNode είναι κόμβος Attr, Document, Entity ή Notation, η μέθοδος θα προκαλέσει εξαίρεση κώδικα INVALID_NODE_TYPE_ERR Αιτία RangeException.

Σε αυτές τις συνθήκες, η μέθοδος θα προκαλέσει επίσης την εξής DOMException εξαίρεση κώδικα:

  • ΑΚΡΙΒΗ_ΑΙΤΗΣΗ_ΕΡΡΟΡ - Ο κόμβος που περιέχει την αρχή της περιοχής δεν μπορεί να έχει υποκείμενα, δεν μπορεί να έχει καθορισμένους τύπους υποκείμενων, ή newNode είναι προγονός του κόμβου (ή ο ίδιος ο κόμβος).
  • NO_MODIFICATION_ALLOWED_ERR - Ο κόμβος που περιέχει τον αρχικό σημείο του εύρους (ή ο προγονός του) είναι只读.
  • WRONG_DOCUMENT_ERR - newNode διαφέρει από το έγγραφο στο οποίο ανήκει το εύρος.

Περιγραφή

Αυτή η μέθοδος θα εισάγει τον καθορισμένο κόμβο (και όλα τα απογόνων του) στο αρχικό σημείο του εύρους του εγγράφου. Όταν αυτή η μέθοδος επιστρέψει, το τρέχον εύρος θα περιλαμβάνει τους νέους κόμβους που εισήχθησαν. Αν newNode είναι ήδη μέρος του εγγράφου, θα αφαιρεθεί από τη θέση του και θα επαναεισαχθεί στο αρχικό σημείο του εύρους. Αν newNode Είναι Κόμβος DocumentFragmentτότε η εισαγωγή δεν είναι η ίδια, αλλά τα απογόνων της, που θα εισαχθούν με σειρά από το αρχικό σημείο του εύρους.

Αν ο κόμβος που περιέχει τον αρχικό σημείο του εύρους είναι κόμβος Text, θα κοπεί σε δύο γειτονικούς κόμβους πριν από την εισαγωγή της κίνησης. Αν newNode Είναι κόμβος Text, μετά την εισαγωγή του στο έγγραφο, δεν θα συγχωνεύσει με καμία κοντινή κόμβο Text. Για να συγχωνεύσετε κοντινούς κόμβους, χρειάζεται να καλέσετε Node.normalize() Μέθοδος.

Δείτε

Το αντικείμενο DocumentFragment, Node.normalize().