Метод XML DOM insertNode()
Определение и использование
Метод insertNode() вставляет узел в начале диапазона.
Синтаксис:
insertNode(newNode)
Параметр
| Параметр | Описание |
|---|---|
| newNode | узел, который нужно вставить в документ. |
выбрасывает
Если newNode Является узлом Attr, Document, Entity или Notation, и этот метод выбрасывает исключение INVALID_NODE_TYPE_ERR с кодом Исключение RangeException.
В следующих условиях этот метод также выбрасывает DOMException исключение с кодом:
- HIERARCHY_REQUEST_ERR - Начальная точка диапазона не может иметь дочерние узлы, он также не может иметь дочерние узлы указанного типа или newNode является предком этого узла (или сам узел).
- NO_MODIFICATION_ALLOWED_ERR - узел, содержащий начало ranges (или его предок), является только для чтения.
- WRONG_DOCUMENT_ERR - newNode имеет документ, отличный от документа, к которому принадлежит диапазон.
Описание
Этот метод вставит указанный узел (и все его потомки) в начало документа ranges. Когда этот метод вернется, текущий диапазон будет включать новоinserted узел. Если newNode Если он уже является частью документа, то он будет удален из текущей позиции и заново вставлен в начало диапазона. Если newNode является Узел DocumentFragment, то вставляется не сам узел, а его потомки, в порядке следования точки начала диапазона.
Если узел, содержащий начало текущего диапазона, является узлом Text, то перед выполнением операции вставки он будет разделен на два смежных узла. Если newNode Это узел Text, после вставки в документ он не будет объединяться с любыми смежными узлами Text. Чтобы объединить смежные узлы, нужно вызвать Node.normalize() Метод.
