このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

Element: getAttributeNode() メソッド

Baseline
広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。

getAttributeNode()Element インターフェイスのメソッドで、指定された要素の指定された属性を Attr ノードとして返します。要素に指定された名前の属性がない場合は、null を返します。

このメソッドは、属性のインスタンスプロパティが必要な場合に役立ちます。 属性の値のみが必要な場合は、代わりに getAttribute() メソッドを使用することができます。

構文

js
getAttributeNode(attrName)

引数

attrName

属性の名前を指定する文字列。HTML 文書としてフラグ付けされた DOM 内の HTML 要素に対してこのメソッドが呼び出された場合、その名前は小文字に正規化されます。

返値

その属性に対応する Attr ノードです。または、要素が指定された名前の属性を保有していない場合は null です。

メモ: Attr ノードは Node を継承していますが、文書ツリーの一部と考えることはできません。一般の Node 属性、例えば parentNodepreviousSiblingnextSibling などは Attr ノードでは null になります。しかしながら、ownerElement プロパティではこの属性が属している要素を取得することができます。

js
// html: <div id="top" />
const t = document.getElementById("top");
const idAttr = t.getAttributeNode("id");
console.log(idAttr.value); // "top"

仕様書

仕様書
DOM
# dom-element-getattributenode

ブラウザーの互換性

関連情報