Méthode XML DOM surroundContents()
Définition et utilisation
La méthode surroundContents() utilise le nœud spécifié pour envelopper le contenu de la plage.
Syntaxe :
surroundContents(newParent)
Paramètres
| Paramètres | Description |
|---|---|
| newParent | deviendra le nouveau parent du contenu de la plage actuelle. |
Lève
Cette méthode lèvera une exception avec le code suivant dans les cas suivants : Exception DOMExceptionou Exception RangeException：
DOMException.HIERARCHY_REQUEST_ERR
le nœud contenant le point de départ de la plage actuelle ne peut pas avoir de sous-nœuds, ni newParent sous-nœud du type, ou newParent Est un ancêtre de nœud contenant.
DOMException.NO_MODIFICATION_ALLOWED_ERR
Le noeud ancêtre du point de fin de la portée actuelle est en lecture seule, et les opérations d'insertion ne sont pas autorisées.
DOMException.WRONG_DOCUMENT_ERR
newParent Et sa portée est créée avec un Document différent.
RangeException.BAD_BOUNDARYPOINTS_ERR
La portée actuelle sélectionne partiellement un noeud (sauf le noeud Texte), donc elle ne peut pas englober cette zone du document.
RangeException.INVALID_NODE_TYPE_ERR
newParent Est un noeud Document, DocumentFragment, DocumentType, Attr, Entity ou Notation.
Description
Cette méthode définira le noeud parent actuel de la portée en tant que newParent, puis newParent Inséré à la position de début de la portée du document. Par exemple, pour insérer une zone du document dans un élément <div> ou <span>, vous pouvez utiliser cette méthode.
Si newParent S'il est déjà une partie du document, il sera d'abord supprimé du document, et ses noeuds enfants seront également abandonnés. Lorsque cette méthode retourne, la portée sera newParent La position précédente est le point de départ,newParent La position suivante est le point de fin.
