Element: setAttributeNS() メソッド

setAttributeNS は、指定された名前空間と名前で、新しい属性を追加したり、属性の値を変更したりします。

構文

js
setAttributeNS(namespace, name, value)

引数

  • namespace は属性の名前空間を指定する文字列です。
  • name は修飾名で属性を識別する文字列です。すなわち、名前空間接頭辞に続いてコロン、続いてローカル名です。
  • value は新しい属性の希望する文字列値です。

返値

なし (undefined)。

js
let d = document.getElementById("d1");
d.setAttributeNS(
  "http://www.mozilla.org/ns/specialspace",
  "spec:align",
  "center",
);

メモ

DOM メソッドは要素の属性を取り扱います。

名前空間に無関係、
最も一般的に使用されるメソッド
名前空間に限定される変数
(DOM Level 2)
Attr ノードを直接扱う DOM レベル 1 のメソッド
(ほとんど使用されない)
Attr ノードを直接扱う DOM レベル 2 名前空間に限定されるメソッド
(ほとんど使用されない)
setAttribute (DOM 1) setAttributeNS setAttributeNode setAttributeNodeNS
getAttribute (DOM 1) getAttributeNS getAttributeNode getAttributeNodeNS
hasAttribute (DOM 2) hasAttributeNS - -
removeAttribute (DOM 1) removeAttributeNS removeAttributeNode -

setAttributeNS は名前空間属性のための唯一のメソッドで、完全修飾名、つまり "namespace:localname" を期待します。

仕様書

Specification
DOM Standard
# ref-for-dom-element-setattributens①

ブラウザーの互換性

BCD tables only load in the browser