XML DOM surroundContents() μέθοδος
Ορισμός και χρήση
Η μέθοδος surroundContents() χρησιμοποιεί τον καθορισμένο κόμβο για να περιβάλλει το περιεχόμενο του διαστήματος.
Γλώσσα:
surroundContents(newParent)
παράμετροι
| παράμετροι | Περιγραφή |
|---|---|
| newParent | θα γίνει ο νέος γονέας του περιεχομένου του τρέχοντος διαστήματος. |
πέσει
Αυτό το μέθοδος θα πέσει σε περίπτωση που έχει τον κώδικα DOMException σφάλμαή RangeException σφάλμα:
DOMException.HIERARCHY_REQUEST_ERR
Ο περιλαμβανόμενος κόμβος του σημείου ξεκινήματος του τρέχοντος διαστήματος δεν μπορεί να έχει υποκλάδους, δεν μπορεί να έχει newParent υποκλάδους τύπου, ή newParent Είναι ο προγονός του περιλαμβανόμενου κόμβου.
DOMException.NO_MODIFICATION_ALLOWED_ERR
Ο προγονικός κόμβος του σημείου ορίου του τρέχοντος εύρους είναι ανίχνευτος, δεν επιτρέπεται η εισαγωγή.
DOMException.WRONG_DOCUMENT_ERR
newParent και το εύρος είναι δημιουργημένο με διαφορετικό αντικείμενο Document.
RangeException.BAD_BOUNDARYPOINTS_ERR
Η τρέχουσα περιοχή επιλέγει μέρος του κόμβου (εκτός του κόμβου Text), οπότε δεν μπορεί να περιβάλλει αυτή την περιοχή του εγγράφου.
RangeException.INVALID_NODE_TYPE_ERR
newParent είναι κόμβος Document, DocumentFragment, DocumentType, Attr, Entity ή Notation.
Περιγραφή
Αυτή η μέθοδος θα επανασυγχρονίσει τον γονικό κόμβο του τρέχοντος εύρους newParent, και μετά newParent τοποθετημένος στην αρχή της περιοχής του εγγράφου. Για παράδειγμα, για να τοποθετήσετε μια περιοχή του εγγράφου μέσα σε στοιχεία <div> ή <span>, μπορείτε να χρησιμοποιήσετε αυτή τη μέθοδο.
Αν newParent Εάν είναι ήδη μέρος του έγγραφου, θα αφαιρεθεί πρώτα από το έγγραφο, και τα υποσυνέργεια του θα απορριφθούν. Όταν αυτή η μέθοδος επιστρέφει, η περιοχή θα είναι newParent Η θέση πριν είναι ο σημείο έναρξης,newParent Η θέση μετά είναι ο σημείο λήξης.
