DOM操作

JavaScriptから画面上の要素を取得したり書き換えたりするには、HTMLをJavaScriptから扱うためのオブジェクト構造である DOM(Document Object Model)を使います。ブラウザはHTMLを読み込むとDOMツリーを構築し、JavaScriptは document オブジェクトを通じてこのツリーへアクセスします。本セクションでは、要素の取得・変更・追加・削除・スタイル変更・イベント処理といったDOM操作の基本を、1つずつ順に扱います。

1. 動作確認用HTMLの準備

以降のサンプルで扱う要素をまとめて用意するため、index.html を以下の内容で上書き保存します。見出しに加えて、要素の取得やクリック操作を試すための <button>、複数要素の取得を試す <ul>、スタイルを変更する対象の <div> を追加しています。

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="UTF-8" />
    <title>JavaScriptの応用構文</title>
  </head>
  <body>
    <h1>こんにちは</h1>
    <button id="btn">クリック</button>
    <ul id="list">
      <li>りんご</li>
      <li>みかん</li>
      <li>ぶどう</li>
    </ul>
    <div id="box">ボックス</div>
    <script src="app.js" defer></script>
  </body>
</html>

保存してブラウザで index.html を再読み込みすると、以下のような画面が表示されます。

見出し「こんにちは」・ボタン「クリック」・箇条書き(りんご / みかん / ぶどう)・ブロック「ボックス」の 4 つの要素が上から順に表示されます。CSS を当てていないため、それぞれの要素はブラウザ標準の見た目で描画されています。

以降のセクションでは、この index.html を出発点として、app.js の中身を段階的に書き換えながらDOM操作を試します。

2. 要素の取得

DOM操作は、まず「対象の要素をJavaScriptで取得する」ところから始まります。取得したい要素が1つか複数かに応じて、document.querySelector と document.querySelectorAll を使い分けます。

2.1 単一要素の取得

HTMLの要素をJavaScriptから取得する方法はいくつか用意されていますが、本章では CSSセレクタと同じ書き方で要素を指定できる document.querySelector を中心に扱います。前章 HTML/CSSの基本 で扱ったCSSセレクタをそのまま流用でき、ID指定・クラス指定・タグ指定・複合セレクタなどを1つのメソッドで扱えるため、記法を統一できるのが利点です。書き方は以下のとおりです。

const 変数 = document.querySelector("CSSセレクタ");

CSSセレクタの部分には、CSSと同じ書き方がそのまま使えます。代表的な指定方法は以下のとおりです。

種類 書き方 例
ID指定 #ID名 #header で id="header" の要素を取得する
クラス指定 .クラス名 .card で class に card を含む要素を取得する
タグ指定 タグ名 p で <p> 要素を取得する
子孫指定 親セレクタ 子セレクタ #list li で <ul id="list"> の中の <li> を取得する
属性指定 タグ名[属性名="値"] input[type="text"] で type="text" の <input> を取得する

マッチする要素が1つも見つからない場合は null が返ります。

これは、<h1> 要素と <button id="btn"> 要素を取得して、それぞれをポップアップで表示するコードです。app.js を以下の内容で上書き保存します。

const heading = document.querySelector("h1");
const button = document.querySelector("#btn");

alert(heading.outerHTML + "\n" + button.outerHTML);

ブラウザで index.html を再読み込み(Command + R または Ctrl + R)すると、以下のようなポップアップが表示されます。

「このページの内容」のタイトルの下に、<h1>こんにちは</h1> と <button id="btn">クリック</button> の 2 つの要素が改行区切りで並んで表示されました。h1 と #btn のセレクタで、それぞれ <h1> 要素と <button> 要素を取得できています。取得した要素の outerHTML プロパティを参照すると、その要素の HTML 表現を文字列として取り出せます。

コードを解説します。

const heading = document.querySelector("h1");

document.querySelector("h1") は <h1> タグの要素を1つ取得します。h1 は要素名そのままなので、# や . を付けずに書きます。

const button = document.querySelector("#btn");

#btn はIDが btn の要素を指すCSSセレクタです。IDはページ内で一意に振る前提のため、document.querySelector で取得すると <button id="btn"> 要素が返ります。

なお、DOM要素を取得するメソッドは document.querySelector 以外にもいくつか用意されています。以下は代表的なものです。

メソッド 用途
document.querySelector("CSSセレクタ") 最初にマッチした1つの要素を返す
document.querySelectorAll("CSSセレクタ") マッチしたすべての要素を NodeList で返す
document.getElementById("id") ID指定で1つの要素を返す。querySelector("#id") と同じ結果になる
document.getElementsByClassName("class") クラス指定で複数要素を HTMLCollection で返す
document.getElementsByTagName("tag") タグ指定で複数要素を HTMLCollection で返す

getElementById / getElementsByClassName / getElementsByTagName は querySelector が普及する前から用意されているメソッドで、既存のコードでもよく見かけます。新規に書く場合は、CSSセレクタで統一的に指定できる querySelector / querySelectorAll を使えば十分です。

2.2 複数要素の取得

document.querySelector は最初にマッチした1つの要素だけを返します。しかし、リストの各項目や同じクラスを持つカードなど、複数の要素をまとめて取得したいケースもあります。その場合は document.querySelectorAll を使います。書き方は以下のとおりです。

const 変数 = document.querySelectorAll("CSSセレクタ");

返り値は、マッチしたすべての要素を含む NodeList と呼ばれるコレクションです。配列に似ていて、forEach メソッドで各要素を順番に処理できます。

これは、<ul id="list"> の中のすべての <li> 要素を取得し、forEach で各要素のテキストを集めてポップアップで表示するコードです。app.js を以下の内容で上書き保存します。

const items = document.querySelectorAll("#list li");

const texts = [];
items.forEach((item) => {
  texts.push(item.textContent);
});
alert(texts.join("\n"));

ブラウザで index.html を再読み込みすると、以下のようなポップアップが表示されます。

「このページの内容」のタイトルの下に、りんご / みかん / ぶどう の 3 つの <li> の中身が改行区切りで並んで表示されました。3 件すべての中身が並んでいることが動作確認のポイントで、querySelectorAll が最初の 1 件だけでなくマッチする全要素を返せていること、forEach で各要素を順に取り出せていることの両方が確認できます。

コードを解説します。

const items = document.querySelectorAll("#list li");

#list li は「IDが list の要素の中にある <li> 要素すべて」を指すセレクタです。querySelectorAll はマッチした要素を NodeList にまとめて返します。

const texts = [];
items.forEach((item) => {
  texts.push(item.textContent);
});
alert(texts.join("\n"));

NodeList は forEach メソッドを持っており、渡したコールバック関数を要素の数だけ呼び出します。forEach の中で item.textContent を配列 texts に集めていき、最後に join("\n") で改行区切りの1つの文字列にまとめて alert() で表示しています。ポップアップが3回連続で出るのを避けるため、集約してから1回だけ出力する形にしています。

3. イベントリスナ

要素を取得できるようになりましたが、取得しただけでは app.js が実行された瞬間の1回きりの処理しか書けません。ユーザ操作(ボタンのクリックやフォーム入力など)をきっかけに何度も処理を動かすには、イベント の発生を待ち受ける イベントリスナ を使います。イベントリスナは addEventListener メソッドで登録します。書き方は以下のとおりです。

要素.addEventListener("イベント名", (event) => {
  // イベント発生時に実行する処理
});

第1引数にはイベント名("click" / "input" / "submit" など)、第2引数にはイベントが発生したときに呼ばれるコールバック関数を渡します。同じ要素に対して複数のリスナを登録することもできます。

これは、ボタンをクリックするとポップアップを表示するだけのコードです。app.js を以下の内容で上書き保存します。

const button = document.querySelector("#btn");

button.addEventListener("click", () => {
  alert("クリックされました");
});

ブラウザで index.html を再読み込みし、「クリック」ボタンを押すと、以下のようなポップアップが表示されます。

「このページの内容」のタイトルの下に「クリックされました」のメッセージが表示されます。ボタンを押すたびに毎回このポップアップが出ることが動作確認のポイントで、addEventListener("click", ...) に渡したコールバック関数が、クリックイベントの発生をきっかけに実行されていることが確認できます。以降のセクションでは、この alert() の部分を実際のDOM操作(テキストの書き換え・スタイルの切り替え・要素の追加)に差し替える形で、クリックをきっかけに画面が動く例を扱います。

コードを解説します。

const button = document.querySelector("#btn");

前のセクションで扱った document.querySelector で、IDが btn の <button> 要素を取得しています。

button.addEventListener("click", () => {
  alert("クリックされました");
});

addEventListener の第1引数に "click" を、第2引数にアロー関数のコールバックを渡します。ここではコールバックの中で alert() を呼ぶだけの単純な処理ですが、ボタンをクリックするたびにこのコールバックが呼ばれる、という骨格は以降のすべての例で共通です。

4. 要素の変更

取得した要素に対しては、中身の文字列を書き換える・クラスやスタイルを付ける・新しい要素を追加する・要素を削除する、といった変更を加えたい場面が出てきます。ここからは、前セクションで扱ったイベントリスナと組み合わせて、代表的な変更手段を1つずつ扱います。

4.1 テキストの書き換え

前のセクションで登録したイベントリスナの中で alert() を呼ぶ代わりに、実際に画面上の要素を書き換えてみます。要素の中身を書き換えるには、textContent プロパティに新しい文字列を代入します。書き方は以下のとおりです。

要素.textContent = "新しい文字列";

textContent は要素の中に表示されている文字列を表すプロパティで、値の読み出しにも書き込みにも使えます。代入した瞬間にDOMツリーが書き換わり、ブラウザの表示も同時に更新されます。

これは、ボタンをクリックしたら <h1> の中身を「こんばんは」に書き換えるコードです。app.js を以下の内容で上書き保存します。

const heading = document.querySelector("h1");
const button = document.querySelector("#btn");

button.addEventListener("click", () => {
  heading.textContent = "こんばんは";
});

ブラウザで index.html を再読み込みすると、最初は「こんにちは」の見出しが表示されます。「クリック」ボタンを押すと、以下のように見出しの文字が「こんばんは」に切り替わります。

ボタンを押す前と後で見出しの文字が変わるのがポイントで、textContent に代入するだけでDOMツリーとブラウザ表示が同時に書き換わることが確認できます。index.html のソースは <h1>こんにちは</h1> のまま変わっていないため、DOM側の状態がそのまま画面に反映されていることも合わせて分かります。

コードを解説します。

button.addEventListener("click", () => {
  heading.textContent = "こんばんは";
});

前セクションで扱った addEventListener の骨格の中で、alert() の代わりに heading.textContent への代入を書きました。テンプレートリテラルと組み合わせれば、変数の値を埋め込んだ動的な文字列を代入することもできます。textContent は要素の中の文字列を書き換えるだけのプロパティですが、要素の変更手段はほかにも多数あります。以降のセクションで代表的なものを扱い、章末で全体像をまとめます。

4.2 クラスの操作

テキストの書き換えを扱ってきましたが、ほかにも要素の見た目そのものを変える方法があります。CSS側にクラスごとのスタイルを定義しておき、JavaScriptからは classList プロパティ経由でクラスの付け外しだけを行う書き方が一般的です。書き方は以下のとおりです。

要素.classList.add("クラス名");     // クラスを追加する
要素.classList.remove("クラス名");  // クラスを削除する
要素.classList.toggle("クラス名");  // クラスがなければ追加し、あれば削除する

これは、ボタンをクリックするたびに <div id="box"> の highlight クラスを付け外しし、そのつどの class 属性の状態をポップアップで表示するコードです。app.js を以下の内容で上書き保存します。

const box = document.querySelector("#box");
const button = document.querySelector("#btn");

button.addEventListener("click", () => {
  box.classList.toggle("highlight");
  alert("現在のクラス: " + (box.className || "(クラスなし)"));
});

ブラウザで index.html を再読み込みし、「クリック」ボタンを1回押すと、以下のようなポップアップが表示されます。

「このページの内容」のタイトルの下に「現在のクラス: highlight」のメッセージが表示されます。もう1度「クリック」を押すと、highlight クラスが取り除かれて以下の表示に変わります。

現在のクラス: (クラスなし)

クリックのたびに highlight の有無が反転することが動作確認のポイントで、classList.toggle が「クラスがあれば削除・なければ追加」を1つのメソッドで担っていることが確認できます。ボタンのアクティブ表示のオン/オフや、モーダルの表示切り替えなど、状態を反転させたい場面で便利です。

コードを解説します。

box.classList.toggle("highlight");

classList.toggle はクラスがあれば削除、なければ追加します。同じ処理を add と remove で書き分ける必要がなくなります。

alert("現在のクラス: " + (box.className || "(クラスなし)"));

className プロパティは、要素の class 属性の中身を空白区切りの文字列として返します。クラスが1つもない場合は空文字列 "" になるため、|| 演算子で (クラスなし) に置き換えて表示しています。

add / remove は「開くタイミングで open クラスを付ける/閉じるタイミングで外す」のように、既にある状態からクラスを追加・削除するだけの用途で使い分けます。

4.3 スタイルの操作

クラスを介さず、JavaScriptから直接インラインスタイルを書き換えたい場合は、style プロパティを使います。書き方は以下のとおりです。

要素.style.プロパティ名 = "値";

CSSのプロパティ名 background-color は、JavaScript側では backgroundColor のようにキャメルケースで書きます。

これは、ボタンをクリックすると <div id="box"> に背景色・文字色・余白のインラインスタイルを付けるコードです。app.js を以下の内容で上書き保存します。

const box = document.querySelector("#box");
const button = document.querySelector("#btn");

button.addEventListener("click", () => {
  box.style.backgroundColor = "lightyellow";
  box.style.color = "darkblue";
  box.style.padding = "12px";
});

ブラウザで index.html を再読み込みすると、最初は「ボックス」と書かれた <div> がブラウザ既定のスタイルで表示されます。「クリック」ボタンを押すと、<div> の見た目が以下のように変わります。

「ボックス」の <div> に淡い黄色の背景色・濃い青の文字色・上下左右12pxの余白が付いた状態に切り替わりました。HTML 側の <div id="box"> には何のスタイルも書いていないにもかかわらず、クリック後に 3 つのスタイルが画面に反映されていれば、style プロパティ経由でインラインスタイルを書き換えられたことが動作確認できます。

コードを解説します。

box.style.backgroundColor = "lightyellow";
box.style.color = "darkblue";
box.style.padding = "12px";

style プロパティ経由でインラインスタイルを設定しています。ブラウザで要素を検証すると、<div id="box" style="background-color: lightyellow; color: darkblue; padding: 12px;"> のように style 属性が追加されているのが確認できます。

💡 ポイント
インラインスタイルはJavaScriptから直接値を書けて手軽ですが、見た目の定義がCSSファイルと app.js に分散するのが難点です。CSS側に .highlight { background-color: lightyellow; } のようなクラスを定義しておき、JavaScriptからは box.classList.add("highlight") のようにクラスの付け外しだけを行う書き方が一般的です。見た目の定義がCSSに集約され、JavaScriptは「どのタイミングでどのクラスを切り替えるか」に専念できます。

4.4 要素の追加・削除

ここまでは既にHTMLに書かれている要素の中身や見た目を書き換えてきましたが、新しい要素を作って追加したり、既存の要素を削除したりする操作もあります。新しい要素は document.createElement で作り、親要素の appendChild メソッドでDOMツリーに追加します。書き方は以下のとおりです。

const 変数 = document.createElement("タグ名");   // 新しい要素を作る
親要素.appendChild(変数);                        // 親要素の末尾に追加する
要素.remove();                                   // 要素をDOMから削除する

これは、ボタンをクリックするたびに <ul id="list"> の末尾に新しい <li> を追加するコードです。app.js を以下の内容で上書き保存します。

const list = document.querySelector("#list");
const button = document.querySelector("#btn");

let count = 0;
button.addEventListener("click", () => {
  count++;
  const newItem = document.createElement("li");
  newItem.textContent = `新しい項目 ${count}`;
  list.appendChild(newItem);
});

ブラウザで index.html を再読み込みすると、リストには最初「りんご/みかん/ぶどう」の 3 項目だけが表示されています。「クリック」ボタンを 1 回押すと、以下のようにリストが変化します。

リストの末尾に「新しい項目 1」が追加され、4 項目になりました。もう 1 回「クリック」を押すと、さらに末尾に項目が追加されます。

「新しい項目 2」が追加され、5 項目のリストになりました。クリックの回数だけリストの末尾に項目が増えていくことが動作確認のポイントで、createElement で作った要素も、appendChild でDOMツリーに追加した時点で画面表示に反映されることが確認できます。

コードを解説します。

const newItem = document.createElement("li");
newItem.textContent = `新しい項目 ${count}`;

document.createElement("li") は、まだDOMツリーには属していない <li> 要素を新しく作ります。この段階では画面には表示されず、textContent などのプロパティは通常の要素と同じように操作できます。

list.appendChild(newItem);

親要素の appendChild を呼ぶと、渡した要素が親要素の末尾に追加されます。この時点で初めてDOMツリーに組み込まれ、画面へ表示されます。

削除するときは、対象の要素に対して remove メソッドを呼び出します。例えば、追加した項目をすべて取り除きたい場合は、document.querySelectorAll で全 <li> を取得し、forEach で各要素の remove() を呼ぶ、といった書き方ができます。

document.querySelectorAll("#list li").forEach((item) => item.remove());

#list li:first-child のようにCSSの疑似クラスと組み合わせれば、「先頭の項目だけを削除」といった特定要素の削除もできます。

ここまでで、DOM操作の基本形「要素を取得する → イベントを登録する → 中身を書き換える/追加する/削除する」を一通り体験できました。以降のセクションでは、この基本を土台にして、外部サービスとの通信やフォームからの送信を組み合わせます。

5. DOM操作で使える主なプロパティ・メソッド

本セクションで扱った書き方は、DOM操作の中でよく使う代表例です。要素の変更・属性の操作・親子要素のたどり方など、他にも多数のプロパティ・メソッドが用意されています。代表的なものは以下のとおりです。

分類 プロパティ / メソッド 用途
要素の変更 textContent 要素の中の文字列を書き換える
要素の変更 innerHTML 要素の中身をHTML文字列で書き換える
要素の変更 value <input> や <textarea> の入力値を書き換える
要素の変更 hidden true を代入すると要素を非表示にする
要素の変更 disabled true を代入すると <button> や <input> を操作不能にする
属性の操作 setAttribute("属性名", "値") href や src など任意の属性を書き換える
属性の操作 getAttribute("属性名") 任意の属性の値を読み出す
クラス・スタイル classList.add / remove / toggle クラスの追加・削除・切り替えを行う
クラス・スタイル style.プロパティ名 インラインスタイル(背景色・幅・高さなど)を書き換える
要素の追加・削除 document.createElement("タグ名") 新しい要素を作る
要素の追加・削除 親要素.appendChild(要素) 親要素の末尾に要素を追加する
要素の追加・削除 要素.remove() 要素をDOMから取り除く
親子要素のたどり方 parentElement 親要素を取得する
親子要素のたどり方 children 子要素のコレクションを取得する

要素が持つプロパティ・メソッドはこの他にも多数あります。網羅的なリファレンスは、Element(MDN Web Docs) に記載があります。

💡 ポイント
素のJavaScriptでDOM操作を書き続けると、要素の追加・削除・状態管理が絡み合ってコードが複雑になりやすいです。この講座の後半で扱うReactは、状態の変化に応じて画面を自動更新してくれるため、DOMを直接書き換える場面が大きく減ります。ここでDOMの仕組みを体験しておくと、Reactが裏で何を肩代わりしているのかを理解しやすくなります。