Método surroundContents() do XML DOM
Definição e uso
O método surroundContents() usa o nó especificado para envolver o conteúdo do intervalo.
Sintaxe:
surroundContents(newParent)
parâmetro
| parâmetro | Descrição |
|---|---|
| newParent | será o nó pai novo do conteúdo do intervalo atual. |
lançar
Este método lançará uma exceção com o seguinte código em várias situações: Exceção DOMExceptionou Exceção RangeException:
DOMException.HIERARCHY_REQUEST_ERR
O nó contido no ponto de início do intervalo atual não pode ter nós filhos, não pode ter newParent o nó filho do tipo ou newParent É o nó ancestral do nó contido.
DOMException.NO_MODIFICATION_ALLOWED_ERR
O nó ancestral do ponto de extremidade atual do escopo é de apenas leitura, operações de inserção não são permitidas.
DOMException.WRONG_DOCUMENT_ERR
newParent e seu escopo foi criado com diferentes objetos Document.
RangeException.BAD_BOUNDARYPOINTS_ERR
A parte atual do escopo escolheu parcialmente um nó (exceto nó Text), então não pode envolver essa área do documento.
RangeException.INVALID_NODE_TYPE_ERR
newParent é nó Document, DocumentFragment, DocumentType, Attr, Entity ou Notation.
Descrição
Este método definirá o nó pai atual do escopo como newParent, e então newParent colocado no início da posição do escopo do documento. Por exemplo, para inserir uma área do documento em um elemento <div> ou <span>, você pode usar este método.
Se newParent Se já é parte do documento, ele será removido do documento primeiro, e seus nós filhos também serão descartados. Quando este método retornar, o escopo será newParent A posição anterior é o ponto de início,newParent A posição subsequente é o ponto de fim.
