Метод XML DOM surroundContents()
Определение и использование
Метод surroundContents() использует指定的 узел для окружения содержимого диапазона.
Синтаксис:
surroundContents(newParent)
параметр
| параметр | Описание |
|---|---|
| newParent | узел, который станет новым родителем содержимого текущего диапазона. |
выбрасывает
Этот метод выбрасывает исключение с кодом, как указано ниже в следующих случаях: исключение DOMExceptionили исключение RangeException:
DOMException.HIERARCHY_REQUEST_ERR
узел, включающий начальную точку текущего диапазона, не может иметь дочерние узлы, не может иметь newParent дочерний узел типа или newParent Это предок узла, включающего узел.
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 После этой позиции будет точкой завершения.
