XML DOM surroundContents() metode
Definition og brug
surroundContents() metoden bruger den angivne node til at omgøre indholdet af rækkevidden.
Syntaks:
surroundContents(newParent)
Parameter
| Parameter | Beskrivelse |
|---|---|
| newParent | vil blive den nye forælder til indholdet af den nuværende rækkevidde. |
kaste
denne metode vil kaste en undtagelse med følgende kode i følgende situationer: DOMException undtagelseeller RangeException undtagelse：
DOMException.HIERARCHY_REQUEST_ERR
den indholdsnoder, der er indeholder i den nuværende rækkevidde, må ikke have undernoder, og den må ikke have newParent undernoden, eller newParent Er forælderen til en indholdsnoder.
DOMException.NO_MODIFICATION_ALLOWED_ERR
Arvingen til den nuværende rades grænsepunkter er skrivebeskyttet, og det er ikke tilladt at udføre indsatte operationer.
DOMException.WRONG_DOCUMENT_ERR
newParent og dens rade er oprettet med en anden Document objekt.
RangeException.BAD_BOUNDARYPOINTS_ERR
Den nuværende rade vælger en del af en node (bortset fra Text node), så den kan ikke omgøre dette område af dokumentet.
RangeException.INVALID_NODE_TYPE_ERR
newParent er Document, DocumentFragment, DocumentType, Attr, Entity eller Notation node.
Beskrivelse
denne metode vil ændre den nuværende rades forældernode til newParent, og så newParent indsat i dokumentets startposition. For eksempel kan man bruge denne metode til at placere et område af dokumentet i et <div> eller <span> element.
Hvis newParent er allerede en del af dokumentet, så det vil først blive fjernet fra dokumentet, og dens undernodes vil også blive kastet væk. Når denne metode returnerer, vil området være newParent Førpositionen er startpunktet,newParent Efterpositionen er slutpunktet.
