element.setAttribute

このページは翻訳中です。
翻訳作業に参加する場合は、履歴にある翻訳者と連絡·調整してください。

概要

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

構文

element.setAttribute(name, value);

• name は属性の名前を文字列で表現したものです。
• value は属性の希望する新しい値です。

例

var d = document.getElementById("d1"); 
d.setAttribute("align", "center");

注記

指定の属性が既に存在しているときはその属性の値はこの関数に渡された値に変更されます。もし存在しなければ属性は新しく作成されます。

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

setAttribute() を使ってある属性、XULやHTMLの特別な値、およびHTMLの選択領域を変更することは、属性がデフォルト値を特定している場合に一貫性なく働きます。現在の値にアクセスしたり、変更したりするにはプロパティを使用すべきです。例としては elt.setAttribute('value', val) の代わりに elt.value を使用します。

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

仕様

DOM Level 2 Core: setAttribute (introduced in DOM Level 1 Core)