.setAttribute()

指定した要素上に新しい属性を追加、または既存の属性の値を変更します。

文法

element.setAttribute(name, value);
引数 説明
name 属性の名前を文字列で指定します。
value 属性に設定したい値を指定します。

var d = document.getElementById("d1");

d.setAttribute("align", "center");

注意事項

HTMLドキュメント内のHTML要素上で呼び出された際に、 setAttributeは引数の属性の名前を小文字にします。

指定された属性が既に存在する場合、 その属性の値は引数として渡された値に変更されます。 存在しない場合は、その属性が作成されます。

getAttribute()は存在しない属性に対してnullを返しますが、 属性を削除する際にelt.setAttribute(attr, null)ではなく、 removeAttribute()を使用すべきです。

特定の値の編集にsetAttribute()を使用すること、特にXUL内の値において、 属性がデフォルト値を指定するものであると、この動作は一貫性の無いものになります。 現在の値にアクセス、または編集を行うには、プロパティを使用すべきです。 例えば、elt.setAttribute('value', val)の代わりに、 elt.valueを使用します。

要素の属性を取扱うDOMメソッド:

名前空間が無関係の
一般的によく使用される
メソッド
名前空間限定
(DOMレベル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 -

仕様

 Back to top

© 2017 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.

このページは、ページトップのURL先のMozilla Developer Network(以下、MDN)のコンテンツを翻訳した内容を基に構成されています。 構成について異なる点も含まれますので、下記の項目を確認し、必要に応じて元のコンテンツをご確認ください。 もし、誤訳などの間違いを見つけましたら、 @tomofまで教えていただければ幸いです。

  • 特定のブラウザに特化しすぎている情報やあまりにも古い情報、 または試験的に導入されているようなAPIや機能については、省略していることがあります。
  • 例やデモについて、実際にページ内で動作させる関係で一部ソースコードを変更している場合や、 その例で使用しているコンテンツの単語や文章などを日本人向けに変更しいてる場合があります。
  • MDNの更新頻度が高いため、元のコンテンツと比べ情報が古くなっている可能性があります。
  • "訳注:"などの断わりを入れた上で、日本人向けの情報の追記を行っている事があります。