DOMImplementation: createDocument() method

Cú pháp

createDocument(namespaceURI, qualifiedName)
createDocument(namespaceURI, qualifiedName, documentType)

Tham số

namespaceURI

Một chuỗi chứa URI không gian tên của tài liệu cần tạo, hoặc null nếu tài liệu không thuộc không gian tên nào.

qualifiedName

Một chuỗi chứa tên đủ điều kiện của tài liệu cần tạo. Giá trị null được xử lý giống như chuỗi rỗng ("").

Định dạng của tên đủ điều kiện là prefix:localName hoặc localName, trong đó các phần được định nghĩa là:

prefix Optional

"Bí danh ngắn" cho không gian tên. Tiền tố là tùy chọn, nhưng nếu được chỉ định thì tham số namespaceURI cũng phải được chỉ định. Nếu tiền tố được đặt là xml hoặc xmlns, namespaceURI phải được đặt thành http://www.w3.org/XML/1998/namespace hoặc http://www.w3.org/2000/xmlns/, tương ứng. Mặc định là null.

localName

Tên cục bộ của tài liệu.

documentType Optional

DocumentType của tài liệu cần tạo. Mặc định là null.

Giá trị trả về

XMLDocument mới được tạo.

Ngoại lệ

NamespaceError DOMException

Được ném ra nếu giá trị namespaceURI:

• không phải URI không gian tên hợp lệ.
• được đặt thành chuỗi rỗng khi prefix có giá trị.
• không phải giá trị http://www.w3.org/XML/1998/namespace hoặc http://www.w3.org/2000/xmlns/ khi prefix được đặt thành xml hoặc xmlns, tương ứng.

InvalidCharacterError DOMException

Được ném ra nếu prefix hoặc localName không hợp lệ.

Ví dụ

Sử dụng cơ bản

const doc = document.implementation.createDocument(
  "http://www.w3.org/1999/xhtml",
  "html",
  null,
);
const body = document.createElementNS("http://www.w3.org/1999/xhtml", "body");
body.setAttribute("id", "abc");
doc.documentElement.appendChild(body);
alert(doc.getElementById("abc")); // [object HTMLBodyElement]

Thông số kỹ thuật

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

Xem thêm

• Giao diện DOMImplementation mà nó thuộc về.