文档: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

浏览器兼容性

另见