Document: phương thức append()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2018.
Phương thức Document.append() chèn một tập hợp các đối tượng Node hoặc chuỗi sau phần tử con cuối cùng của tài liệu. Các chuỗi được chèn vào dưới dạng các nút Text tương đương.
Phương thức này thêm một phần tử con vào một Document. Để thêm vào một phần tử bất kỳ trong cây, xem Element.append().
Cú pháp
append(param1)
append(param1, param2)
append(param1, param2, /* …, */ paramN)
Tham số
param1, …,paramN-
Một tập hợp các đối tượng
Nodehoặc chuỗi cần chèn.
Giá trị trả về
Không có (undefined).
Ngoại lệ
HierarchyRequestErrorDOMException-
Được ném ra khi node không thể được chèn tại điểm được chỉ định trong hệ thống phân cấp.
Ví dụ
Thêm một phần tử gốc vào tài liệu
Nếu bạn cố gắng thêm một phần tử vào một tài liệu HTML hiện có, nó có thể ném ra HierarchyRequestError DOMException vì một phần tử <html> đã tồn tại.
let html = document.createElement("html");
document.append(html);
// HierarchyRequestError: The operation would yield an incorrect node tree.
Nếu bạn đang tạo một tài liệu mới mà không có phần tử hiện có nào, bạn có thể thêm một phần tử HTML gốc (hoặc một phần tử SVG gốc):
let doc = new Document();
let html = document.createElement("html");
doc.append(html);
doc.children; // HTMLCollection [<html>]
Đặc tả kỹ thuật
| Thông số kỹ thuật |
|---|
| DOM # ref-for-dom-parentnode-append① |