XML DOM surroundContents() metod
Definition och användning
surroundContents() metoden använder den angivna noden för att omge innehållet i intervallet.
Syntaks:
surroundContents(newParent)
Parameter
| Parameter | Beskrivning |
|---|---|
| newParent | kommer att bli den nya föräldern till innehållet i den aktuella intervallet. |
kastar
Denna metod kommer att kasta ett undantag med följande kod i följande fall: DOMException-undantageller RangeException-undantag:
DOMException.HIERARCHY_REQUEST_ERR
den inneslutande noden för början av den aktuella intervallet får inte ha undernoder, och får inte ha newParent undernoder av typen, eller newParent Är föregångaren till en inneslutande nod.
DOMException.NO_MODIFICATION_ALLOWED_ERR
Ancestorn till den aktuella områdets gräns punkter är skrivskyddade och tillåter inte inmatningsoperationer.
DOMException.WRONG_DOCUMENT_ERR
newParent och dess område är skapat med en annan Document objekt.
RangeException.BAD_BOUNDARYPOINTS_ERR
Det aktuella området väljer en del av en nod (utom Text noder), så det är inte möjligt att omge detta område i dokumentet.
RangeException.INVALID_NODE_TYPE_ERR
newParent är Document, DocumentFragment, DocumentType, Attr, Entity eller Notation noder.
Beskrivning
Denna metod kommer att definiera den aktuella områdets föräldernod om till newParent, och sedan newParent Infoga i början av dokumentets område. Till exempel, placera en del av dokumentet i <div> eller <span> elementet, kan du använda denna metod.
Om newParent Om det redan är en del av dokumentet, kommer det först att tas bort från dokumentet, och dess barnnoder kommer också att kastas bort. När denna metod returnerar kommer området att vara newParent Innan platsen är startpunkten,newParent Efter platsen är slutpunkten.
