XML DOM surroundContents() วิธีการ

คู่มืออ้างอิงวัตถุ Range

การระบุและการใช้งาน

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 ตำแหน่งหลังจากนี้เป็นจุดสิ้นสุด

คู่มืออ้างอิงวัตถุ Range