言語
日本語
English

Caution

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

JavaScript辞典

  1. トップページ
  2. JavaScript辞典
  3. document.getElementById()

document.getElementById() 対応: DOM Level 1(1998)

指定したID名を持つHTML要素をドキュメント内から取得します。IDはページ内で一意であるため、常に1つのHTML要素のみが返されます。

構文

var element = document.getElementById("ID名");

引数

引数概要
ID名取得したいHTML要素のID名を文字列で指定します。『#』は不要です。

戻り値

指定したIDを持つHTML要素(Elementオブジェクト)を返します。該当するHTML要素が存在しない場合は『null』を返します。

サンプルコード

<h1 id="title">メインタイトル</h1>
<p id="description">ここは説明文です。</p>
var title = document.getElementById("title");
console.log(title.textContent); // 『メインタイトル』と出力されます。

var desc = document.getElementById("description");
desc.textContent = "説明文を変更しました。";

HTML要素が見つからない場合

存在しないIDを指定すると『null』が返されます。『null』のまま操作しようとするとエラーになります。document.querySelector()』と同様に、nullチェックをしてから操作してください。

// 存在しないIDを指定します。
var el = document.getElementById("nothing");
el.innerHTML = "<p>テスト</p>"; // TypeError: Cannot set properties of null

// 正しい書き方
var el = document.getElementById("title");
if (el) {
	el.innerHTML = "<p>新しいタイトル</p>";
}

概要

『document.getElementById()』はID名でHTML要素を取得する最もシンプルなメソッドです。ID名はページ内で一意でなければならないため、必ず1つのHTML要素だけが返されます。

同様の取得は『document.querySelector("#ID名")』でも可能ですが、『document.getElementById()』の方が内部的な処理が高速なため、IDでHTML要素を取得する場合は『document.getElementById()』の使用をおすすめします。

引数にはID名の文字列のみを指定します。CSSセレクタのように『#』を付ける必要はありません。『#』を付けると正しく取得できませんのでご注意ください。

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

対応ブラウザ

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

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