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 Позиция после этого является точкой завершения.