Range: phương thức surroundContents()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Phương thức surroundContents() của giao diện Range bao quanh nội dung đã chọn bằng một nút được cung cấp. Nó trích xuất nội dung của range, thay thế các nút con của newParent bằng nội dung đã trích xuất, chèn newParent vào vị trí của nội dung đã trích xuất, rồi làm cho range chọn newParent.
Một ngoại lệ sẽ được ném ra nếu range chỉ chứa một phần của bất kỳ nút nào không phải Text. Range phải chỉ chứa các nút văn bản và các nút được chọn hoàn toàn.
Cú pháp
js
surroundContents(newParent)
Tham số
Giá trị trả về
Không có (undefined).
Ví dụ
>HTML
html
<span class="header-text">Put this in a headline</span>
JavaScript
js
const range = document.createRange();
const newParent = document.createElement("h1");
range.selectNode(document.querySelector(".header-text"));
range.surroundContents(newParent);
Kết quả
Thông số kỹ thuật
| Specification |
|---|
| DOM> # dom-range-surroundcontents> |