文件:createAttributeNS() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

Document.createAttributeNS() 方法使用指定的名稱空間 URI 和限定名稱建立一個新的屬性節點,並返回該節點。建立的物件是實現 Attr 介面的節點。DOM 不強制要求以這種方式向特定元素新增什麼型別的屬性。

語法

js
createAttributeNS(namespaceURI, qualifiedName)

引數

namespaceURI

一個指定要與屬性關聯的 namespaceURI 的字串。一些重要的名稱空間 URI 是:

HTML

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

SVG

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

MathML

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

qualifiedName(限定名稱)

一個指定要建立的屬性名稱的字串。建立的屬性的 name 屬性將使用 qualifiedName 的值進行初始化。

返回值

新的 Attr 節點。

異常

NamespaceError DOMException

如果 namespaceURI 值不是有效的名稱空間 URI,則丟擲此異常。

InvalidCharacterError DOMException

如果 qualifiedName 值不是有效的 XML 名稱,則丟擲此異常;例如,它以數字、連字元或句點開頭,或者包含除字母數字字元、下劃線、連字元或句點之外的字元。

示例

js
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"

規範

規範
DOM
# dom-document-createattributens

瀏覽器相容性

另見