Metodo insertNode() XML DOM
Definizione e utilizzo
Il metodo insertNode() inserisce un nodo all'inizio della gamma.
sintassi:
insertNode(newNode)
parametro
| parametro | Descrizione |
|---|---|
| newNode | i nodi da inserire nel documento. |
lancia
se newNode è un nodo Attr, Document, Entity o Notation, il metodo genererà un errore con il codice INVALID_NODE_TYPE_ERR eccezione RangeException.
sotto le seguenti condizioni, il metodo genererà l'eccezione DOMException con il seguente codice:
- ERRO_REQUISITO gerarchico - Il nodo di inizio dell'intervallo non può avere figli, né figli di tipo specificato, né newNode È un antenato del nodo (o il nodo stesso).
- NO_MODIFICATION_ALLOWED_ERR - Il nodo che contiene il punto di inizio dell'intervallo (o un antenato del nodo) è readonly.
- WRONG_DOCUMENT_ERR - newNode Diverso dal documento a cui appartiene l'intervallo.
Descrizione
Questo metodo inserirà il nodo specificato (e tutti i suoi discendenti) nel punto di inizio dell'intervallo del documento. Al momento del ritorno di questo metodo, l'intervallo corrente includerà i nodi inseriti di recente. Se newNode Se è già parte del documento, allora verrà rimosso dalla posizione corrente e reinserito al punto di inizio dell'intervallo. Se newNode È Nodo DocumentFragment, allora non sarà inserito se stesso, ma i suoi discendenti, in ordine di inserimento del punto di inizio dell'intervallo.
Se il nodo che contiene il punto di inizio dell'intervallo è un nodo Text, allora prima dell'operazione di inserimento, sarà diviso in due nodi adiacenti. Se newNode È un nodo Text, dopo aver inserito il documento, non si fonderà con alcun nodo Text adiacente. Per fondere nodi adiacenti, è necessario chiamare Node.normalize() Metodo.
