Document: replaceChildren() method
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 Document.replaceChildren() thay thế các phần tử con hiện có của một Document bằng một tập hợp phần tử con mới được chỉ định.
Cú pháp
js
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ủaDocument. Nếu không chỉ định đối tượng thay thế nào, thìDocumentsẽ bị xóa tất cả các phần tử con.
Giá trị trả về
Không có (undefined).
Ngoại lệ
HierarchyRequestErrorDOMException-
Được ném nếu vi phạm các ràng buộc của cây nút.
Ví dụ
Làm trống một tài liệu
replaceChildren() cung cấp một cơ chế rất tiện lợi để làm trống một tài liệu khỏi tất cả các phần tử con. Bạn gọi nó trên tài liệu mà không cần đối số nào:
js
document.replaceChildren();
document.children; // HTMLCollection []
Đặc tả kỹ thuật
| Specification |
|---|
| DOM # ref-for-dom-parentnode-replacechildren① |