Metodo surroundContents() dell'XML DOM
Definizione e uso
Il metodo surroundContents() utilizza il nodo specificato per avvolgere il contenuto dell'intervallo.
Sintassi:
surroundContents(newParent)
parametro
| parametro | Descrizione |
|---|---|
| newParent | il nodo diventerà il nuovo padre del contenuto dell'intervallo corrente. |
sollevare
Questo metodo solleverà un'eccezione con il seguente codice in queste circostanze: eccezione DOMExceptiono eccezione RangeException:
DOMException.HIERARCHY_REQUEST_ERR
il nodo contenitore del punto di inizio dell'intervallo corrente non può avere figli, non può avere newParent sottostante il tipo, o newParent È il nodo antenato del nodo contenitore.
DOMException.NO_MODIFICATION_ALLOWED_ERR
Il nodo antenato del punto di boundary della gamma corrente è readonly, non è permesso eseguire operazioni di inserimento.
DOMException.WRONG_DOCUMENT_ERR
newParent e la sua gamma è stata creata con un diverso oggetto Document.
RangeException.BAD_BOUNDARYPOINTS_ERR
La gamma corrente seleziona parzialmente un nodo (tranne il nodo Text), quindi non può avvolgere questa area del documento.
RangeException.INVALID_NODE_TYPE_ERR
newParent Sono nodi Document, DocumentFragment, DocumentType, Attr, Entity o Notation.
Descrizione
Questo metodo riposizionerà il nodo genitore attuale come newParent, quindi metti newParent Inserito nel punto di inizio della gamma del documento. Ad esempio, per inserire un'area del documento all'interno di un elemento <div> o <span>, è possibile utilizzare questo metodo.
Se newParent Se già parte del documento, verrà prima rimosso dal documento, e i suoi nodi figli saranno scartati. Al momento del ritorno di questo metodo, la gamma sarà newParent La posizione precedente è il punto di inizio,newParent La posizione successiva è il punto di fine.
