言語
日本語
English

Caution

お使いのブラウザはJavaScriptが無効になっております。
当サイトでは検索などの処理にJavaScriptを使用しています。
より快適にご利用頂くため、JavaScriptを有効にしたうえで当サイトを閲覧することをお勧めいたします。

JavaScript辞典

  1. トップページ
  2. JavaScript辞典
  3. HTML要素.getAttribute()

HTML要素.getAttribute() 対応: DOM Level 1(1998)

HTML要素の指定した属性の値を文字列として取得します。属性が存在しない場合は『null』を返します。

構文

var value = element.getAttribute("属性名");

引数

引数概要
属性名取得したい属性の名前を文字列で指定します。大文字・小文字は区別されません。

戻り値

指定した属性の値を文字列で返します。属性が存在しない場合は『null』を返します。

サンプルコード

<a id="link" href="https://example.com" target="_blank" data-category="external">リンク</a>
<img id="photo" src="/img/photo.jpg" alt="写真" width="300">
var link = document.querySelector("#link");

console.log(link.getAttribute("href"));          // 『https://example.com』と出力されます。
console.log(link.getAttribute("target"));         // 『_blank』と出力されます。
console.log(link.getAttribute("data-category"));  // 『external』と出力されます。

var img = document.querySelector("#photo");
console.log(img.getAttribute("alt"));    // 『写真』と出力されます。
console.log(img.getAttribute("width"));  // 『300』と出力されます。

// 存在しない属性
console.log(link.getAttribute("title")); // 『null』が返されます。

概要

『HTML要素.getAttribute()』はHTML要素の属性の値を文字列として取得するメソッドです。標準の属性(『href』『src』『class』など)はもちろん、『data-*』属性(カスタムデータ属性)の値も取得できます。

属性の値を設定したい場合は『HTML要素.setAttribute()』を使用してください。

なお、一部のプロパティ(『value』『checked』など)はHTML属性とDOMプロパティで値が異なる場合があります。フォームの現在の値を取得する場合は『getAttribute("value")』ではなく、プロパティとして『HTML要素.value』を使用する方が確実です。

『HTML要素.getAttribute()』はチュートリアル記事『id名で要素を特定してその属性を操作してみよう』で、より詳しく解説しています。良ければご覧下さい。

対応ブラウザ

Chrome Chrome
49 以降
全バージョンで対応しています
Firefox Firefox
57 以降
全バージョンで対応しています
Safari Safari
18 以降
全バージョンで対応しています
Edge Edge
80 以降
11 以前 ×
IE IE
11 以降
4 以前 ×
Opera Opera
48 以降
7 以前 ×
iOS Safari iOS Safari
18 以降
全バージョンで対応しています
Android Browser Android Browser
37 以降
4 以前 ×
Chrome Android Chrome Android
36 以降
17 以前 ×
Firefox Android Firefox Android
79 以降
3 以前 ×

記事の間違いや著作権の侵害等ございましたらお手数ですがまでご連絡頂ければ幸いです。