Método XML DOM surroundContents()
Definición y uso
El método surroundContents() usa el nodo especificado para rodear el contenido del rango.
Sintaxis:
surroundContents(newParent)
Parámetros
| Parámetros | Descripción |
|---|---|
| newParent | El nodo se convertirá en el nuevo padre del contenido del rango actual. |
Lanzar
Este método lanzará una excepción con el siguiente código en las siguientes situaciones: Excepción DOMExceptiono Excepción RangeException:
DOMException.HIERARCHY_REQUEST_ERR
El nodo包容 del punto de inicio del rango actual no puede tener nodos hijos, no puede tener newParent El nodo hijo de un tipo, o newParent Es el nodo padre de un nodo包容。
DOMException.NO_MODIFICATION_ALLOWED_ERR
El nodo ancestor del punto de final del rango actual es de solo lectura y no se permite la operación de inserción.
DOMException.WRONG_DOCUMENT_ERR
newParent y su rango se creó con un objeto Document diferente.
RangeException.BAD_BOUNDARYPOINTS_ERR
La parte del rango selecciona parcialmente un nodo (excepto el nodo Texto), por lo que no puede rodear este área del documento.
RangeException.INVALID_NODE_TYPE_ERR
newParent es un nodo Document, DocumentFragment, DocumentType, Attr, Entity o Notation.
Descripción
Este método redefinirá el nodo padre actual del rango como newParent, luego newParent Intercalado en la posición de inicio del rango del documento. Por ejemplo, para insertar un área del documento en un elemento <div> o <span>, se puede usar este método.
Si newParent Si ya es parte del documento, primero se eliminará del documento, y también se descartarán sus nodos hijos. Al regresar este método, el rango se encontrará newParent La posición anterior es el punto de inicio,newParent La posición posterior es el punto de final.
