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ố

newParent

Một Node dùng để bao quanh nội dung.

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

Tương thích trình duyệt

Xem thêm