Element: setAttributeNS() メソッド

構文

setAttributeNS(namespaceURI, qualifiedName, value)

引数

namespaceURI

設定する属性の名前空間を指定する文字列、または空文字列です。

qualifiedName

修飾名によって属性を識別する文字列。この修飾名は prefix:localName または localName の形をとります。各部分の定義は以下の通りです。

prefix

名前空間の「短い別名」です。 接頭辞はオプションですが、指定する場合は namespaceURI 引数も同時に指定する必要があります。 接頭辞が xml または xmlns に設定されている場合、namespaceURI はそれぞれ http://www.w3.org/XML/1998/namespace または http://www.w3.org/2000/xmlns/ に設定する必要があります。

localName

その属性のローカル名です。

value

属性に割り当てる値を含む信頼型または文字列です。

信頼型が強制されている場合、以下の属性に対しては信頼型のインスタンスを渡す必要があります。

• onclick や onload などのイベントハンドラーのコンテンツ属性には、TrustedScript が要求されます。
• HTMLIFrameElement.srcdoc には、TrustedHTML のインスタンスが要求されます。
• HTMLScriptElement.src には、TrustedScriptURL のインスタンスが要求されます。
• SVGScriptElement.href には、TrustedScriptURL のインスタンスが要求されます。

その他の属性については、信頼型が強制されないため、文字列や任意の信頼型を渡すことができます。

返値

なし (undefined)。

例外

NamespaceError DOMException

namespaceURI の値が以下の場合の発生します。

• 有効な名前空間 URI ではない。
• prefix に値があるときに空文字列を設定した。
• prefix が xml または xmlns に設定された場合に、それぞれ http://www.w3.org/XML/1998/namespace または http://www.w3.org/2000/xmlns/ ではない場合。

InvalidCharacterError DOMException

prefix または localName のいずれかが無効な場合、例外が発生します。

• prefix は 1 文字以上でなければならず、ASCII のホワイトスペース、NULL、/、>（それぞれ U+0000、U+002F、U+003E）が含まれてはなりません。
• localName は 1 文字以上でなければならず、ASCII のホワイトスペース、NULL、/、=、>（それぞれ U+0000、U+002F、U+003D、U+003E）が含まれてはなりません。

メモ: 仕様の以前のバージョンでは、qualifiedName が有効な XML 名 であることが要求されるなど、より厳しい制約が設けられていました。

TypeError

value に、信頼型オブジェクトではなく文字列が渡された場合（それらを要求される属性について）、 信頼型が CSP によって強制されている場合で、かつデフォルトのポリシーが定義されていない場合に発生します。

例

基本的な使い方

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

信頼型

setAttribute() の安全はでない属性の設定の例では、setAttributeNS() とともに 信頼型を使用する方法が示されています。

仕様書

ブラウザーの互換性

関連情報

• Element.hasAttributeNS()
• Element.getAttributeNS()
• Element.removeAttributeNS()
• Element.setAttribute()