Document: phương thức createAttributeNS()

Cú pháp

createAttributeNS(namespaceURI, qualifiedName)

Tham số

namespaceURI

Một chuỗi chỉ định namespaceURI để liên kết với thuộc tính, hoặc chuỗi rỗng. Một số URI namespace quan trọng là:

HTML

http://www.w3.org/1999/xhtml

SVG

http://www.w3.org/2000/svg

MathML

http://www.w3.org/1998/Math/MathML

qualifiedName

Một chuỗi chứa qualified name của thuộc tính mới. Thuộc tính name của thuộc tính được tạo được khởi tạo với giá trị này.

Định dạng của qualified name là prefix:localName hoặc localName, trong đó các phần được định nghĩa là:

prefix Optional

Một "bí danh ngắn" cho namespace. 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 thành xml hoặc xmlns, thì 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.

Giá trị được sử dụng để khởi tạo thuộc tính prefix của thuộc tính mới. Mặc định là null.

localName

Tên cục bộ của thuộc tính. Giá trị được sử dụng để khởi tạo thuộc tính localName của thuộc tính mới.

Giá trị trả về

Nút Attr mới.

Ngoại lệ

NamespaceError DOMException

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

• không phải là URI namespace hợp lệ.
• được đặt thành chuỗi rỗng khi prefix có giá trị.
• không phải là 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ệ:

• prefix phải có ít nhất một ký tự và không được chứa khoảng trắng ASCII, NULL, / hoặc > (lần lượt là U+0000, U+002F hoặc U+003E).
• localName phải có ít nhất một ký tự và không được chứa khoảng trắng ASCII, NULL, /, = hoặc > (lần lượt là U+0000, U+002F, U+003D hoặc U+003E).

Note: Các phiên bản trước của đặc tả kỹ thuật hạn chế hơn, yêu cầu localName phải là một tên XML hợp lệ.

Ví dụ

Sử dụng cơ bản

const node = document.getElementById("svg");
const a = document.createAttributeNS("http://www.w3.org/2000/svg", "viewBox");
a.value = "0 0 100 100";
node.setAttributeNode(a);
console.log(node.getAttribute("viewBox")); // "0 0 100 100"

Đặc tả kỹ thuật

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

Xem thêm

• Document.createAttribute()
• Document.createElementNS()
• Element.setAttributeNS()
• Element.setAttributeNode()
• Element.setAttributeNodeNS()