Ang XML DOM surroundContents() na paraan

Definisyon at Paggamit

Ang paraan na surroundContents() ay gumagamit ng nakaugnay na bagay upang hugasan ang nilalaman ng saklaw.

Gramata:

surroundContents(newParent)

Parametro

Parametro Описание
newParent Ang nakaugnay na bagay na magiging magulang ng nilalaman ng kasalukuyang saklaw ay.

maghahabla

Ang paraan na ito ay maghahabla ng may mga code na gayon sa mga sumusunod na sitwasyon: DOMException pagkakamalio RangeException pagkakamali:

DOMException.HIERARCHY_REQUEST_ERR

Ang包容节点 na nasa simula ng kasalukuyang saklaw ay hindi dapat magkaroon ng mga anak, hindi dapat magkaroon ng newParent ang mga anak na nakaugnay sa uri, o newParent Ang magiging magulang na nakaugnay sa包容节点.

DOMException.NO_MODIFICATION_ALLOWED_ERR

Родительские узлы границ текущего диапазона являются только чтением и не позволяют выполнять вставку.

DOMException.WRONG_DOCUMENT_ERR

newParent и его диапазон создан с помощью различных объектов Document.

RangeException.BAD_BOUNDARYPOINTS_ERR

Текущий диапазон частично выбирает узел (кроме узлов Text), поэтому он не может окружать этот участок документа.

RangeException.INVALID_NODE_TYPE_ERR

newParent является узлом Document, DocumentFragment, DocumentType, Attr, Entity или Notation.

Описание

Этот метод изменит родительский узел текущего диапазона на newParent, затем newParent вставлен в начало диапазона документа. Например, чтобы поместить один из разделов документа в элемент <div> или <span>, можно использовать этот метод.

Если newParent если он уже является частью документа, то он сначала будет удален из документа, а его дочерние узлы также будут удалены. Когда этот метод вернется, диапазон будет представлен newParent Позиция до этого является точкой начала,newParent Позиция после этого является точкой завершения.