XML DOM surroundContents() -menetelmä
Määrittely ja käyttö
surroundContents() -menetelmä käyttää määritettyä solmua ympäröimään alueen sisällön.
Syntaksi:
surroundContents(newParent)
parametrit
| parametrit | kuvaus |
|---|---|
| newParent | tulee olemaan uusi isäsolmu nykyisen alueen sisällölle. |
heittää
Tämä metodi heittää poikkeuksen, jolla on seuraava koodi seuraavissa tilanteissa: DOMException poikkeustai RangeException poikkeus:
DOMException.HIERARCHY_REQUEST_ERR
nykyisen alueen alkupisteen sisältävä solmu ei voi olla lapsisolmuja, ei voi olla newParent tyyppinen lapsisolmu tai newParent On sisältävän solmun isäsolmu.
DOMException.NO_MODIFICATION_ALLOWED_ERR
Nykyisen laajuden rajoituspisteiden esi-isäsolmu on kirjoitussuojattu, eikä lisäysoperaatioita ole sallittu.
DOMException.WRONG_DOCUMENT_ERR
newParent ja sen laajuus on luotu eri Document-objektilla.
RangeException.BAD_BOUNDARYPOINTS_ERR
Nykyinen laajuus valitsi osittain solmun (ei Text-solmu), joten sitä ei voida ympäröidä tämän dokumentin alueella.
RangeException.INVALID_NODE_TYPE_ERR
newParent on Document, DocumentFragment, DocumentType, Attr, Entity tai Notation-solmu.
kuvaus
Tämä metodi määrittää nykyisen laajuden isäntänodeiksi newParent, sitten newParent liitetty dokumentin laajuuden alkupisteeseen. Esimerkiksi, jos haluat asettaa dokumentin alueen <div> tai <span>-elementtiin, voit käyttää tätä metodia.
Jos newParent Jos se on jo dokumentin osa, se poistetaan ensin dokumentista, ja sen lapsisolmut hylätään. Kun tämä metodi palauttaa, laajuus on newParent Sijainti, joka on edellä, on alkupiste,newParent Sijainti, joka on jäljessä, on loppupiste.
