Document: phương thức prepend()
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.prepend() chèn một tập hợp các đối tượng Node hoặc chuỗi trước phần tử con đầu tiên của tài liệu. Các chuỗi được chèn dưới dạng các nút Text tương đương.
Phương thức này chèn một phần tử con vào đầu Document. Để chèn vào đầu một phần tử bất kỳ trong cây, xem Element.prepend().
Cú pháp
prepend(param1)
prepend(param1, param2)
prepend(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 nút không thể được chèn tại điểm đã chỉ định trong phân cấp.
Ví dụ
Chèn một phần tử gốc vào tài liệu
Nếu bạn cố chèn một phần tử vào một tài liệu HTML hiện có, nó có thể ném HierarchyRequestError DOMException vì một phần tử <html> đã tồn tại.
let html = document.createElement("html");
document.prepend(html);
// HierarchyRequestError: Thao tác sẽ tạo ra một cây nút không chính xác.
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ó, bạn có thể chèn 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.prepend(html);
doc.children; // HTMLCollection [<html>]
Đặc tả kỹ thuật
| Thông số kỹ thuật |
|---|
| DOM # ref-for-dom-parentnode-prepend① |