XML DOM surroundContents() ວິທີການ

Range 对象参考手册

ການອະທິບາຍແລະການນໍາໃຊ້

ວິທີການ surroundContents() ນຳໃຊ້ພະນັກງານສະເພາະເພື່ອລວມຂອງຂົງຂັ້ນດັ່ງກ່າວ.

ວິທີການ:

surroundContents(newParent)

ສະເພາະ

ສະເພາະ 描述
newParent ອອກມາຈາກຂອງພະນັກງານໃໝ່ທີ່ຈະກາຍເປັນປະກອບຂອງຂົງຂັ້ນທີ່ເລີ່ມຂອງຂົງຂັ້ນດັ່ງກ່າວ.

ປາກົດມາ

ວິທີການຈະປາກົດມາໃນການມີລະຫັດວິທີການດັ່ງກ່າວ DOMException Exceptionຫຼື RangeException Exception:

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 插在文档中范围的开始位置。例如，把文档的一个区域放入

或 元素中，可以使用该方法。

如果 newParent 已经是文档的一部分，那么它首先将从文档中删除，它的子节点也将被舍弃。当该方法返回时，该范围将以 newParent 之前的位置为开始点，newParent 之后的位置为结束点。

Range 对象参考手册