DocumentFragment: phương thức replaceChildren()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2020.
Phương thức DocumentFragment.replaceChildren() thay thế các phần tử con hiện có của một DocumentFragment bằng một tập hợp phần tử con mới đã chỉ định. Các phần tử này có thể là chuỗi hoặc các đối tượng Node.
Cú pháp
replaceChildren(param1)
replaceChildren(param1, param2)
replaceChildren(param1, param2, /* …, */ paramN)
Tham số
param1, …,paramN-
Một tập hợp các đối tượng
Nodehoặc chuỗi để thay thế các phần tử con hiện có củaDocumentFragment. Nếu không có đối tượng thay thế nào được chỉ định, thìDocumentFragmentsẽ bị làm trống tất cả các nút con.
Giá trị trả về
Không có (undefined).
Ngoại lệ
HierarchyRequestErrorDOMException-
Được ném khi các ràng buộc của cây nút bị vi phạm.
Ví dụ
Làm trống một phân đoạn tài liệu
replaceChildren() cung cấp một cơ chế rất tiện lợi để làm trống một phân đoạn tài liệu khỏi tất cả các phần tử con của nó. Bạn gọi nó trên phân đoạn tài liệu mà không có đối số nào được chỉ định:
let fragment = new DocumentFragment();
let div = document.createElement("div");
let p = document.createElement("p");
fragment.append(p);
fragment.prepend(div);
fragment.children; // HTMLCollection [<div>, <p>]
fragment.replaceChildren();
fragment.children; // HTMLCollection []
Đặc điểm kỹ thuật
| Thông số kỹ thuật |
|---|
| DOM # ref-for-dom-parentnode-replacechildren① |