【JavaScript】DOM要素を削除する remove() と removeChild() の違いと活用デモ

JavaScriptで画面上のHTML要素(DOM)を削除したい時、主に使われるメソッドとして remove() と removeChild() の2つがあります。

削除したい要素に対して直接命令できる remove() がシンプルでよく使われますが、古くからある removeChild() にも「削除した要素を返り値として受け取れる(別の場所で再利用できる)」という利点があります。

今回は、リストにアイテムを追加・削除できるデモを通して、2つのメソッドの書き方の違いや、返り値を活かした「ゴミ箱移動(履歴表示)」の仕組みを分かりやすく解説します!

デモ動作

See the Pen JSでDOM要素を削除!remove()とremoveChild()の違いと使い分け by mikanbako (@mikanbako) on CodePen.

全画面でのデモ動作は以下のリンクからご確認下さい!(別タブで開かれます)

実装コード紹介

【HTML】

<div class="l-wrap">
  <h2>DOM要素の削除 比較デモ</h2>
  <p class="p-desc">アイテムの追加と、2種類のメソッドによる削除の違いを試せます!</p>
  
  <div class="p-demo-box">
    <!-- アイテム追加ボタン -->
    <button class="c-btn-add js-btn-add">➕ 新しいアイテムを追加 (append)</button>

    <!-- メインのリスト -->
    <h3 class="c-title">📋 現在のリスト</h3>
    <ul class="c-list js-list">
      <li class="c-list__item">
        <span class="c-item-text">アイテム 1</span>
        <div class="c-btn-group">
          <button class="c-btn c-btn--remove js-remove">remove()</button>
          <button class="c-btn c-btn--child js-remove-child">removeChild()</button>
        </div>
      </li>
      <li class="c-list__item">
        <span class="c-item-text">アイテム 2</span>
        <div class="c-btn-group">
          <button class="c-btn c-btn--remove js-remove">remove()</button>
          <button class="c-btn c-btn--child js-remove-child">removeChild()</button>
        </div>
      </li>
    </ul>

    <!-- removeChildの返り値を活用するエリア -->
    <div class="p-trash">
      <h3 class="c-title">🗑️ 直前に removeChild() で削除した要素</h3>
      <p class="p-trash__desc">※返り値を受け取って、ここに移動(再利用)させています</p>
      <div class="c-trash-box js-trash-box">まだありません</div>
    </div>
  </div>
</div>

【CSS】

/* ベース装飾 */
.l-wrap {
  padding: 40px 20px;
  max-width: 600px;
  margin: 0 auto;
  color: #3e3e3e;
  text-align: center;
}

h2 {
  margin-bottom: 10px;
  font-size: 16px;
  color: #1bb4d4;
}

.p-desc {
  margin-bottom: 30px;
  font-size: 16px;
  font-weight: bold;
  color: #666;
  line-height: 1.6;
}

.p-demo-box {
  padding: 30px;
  text-align: left;
  background: #fff;
  border-radius: 12px;
  box-shadow: 0 4px 15px rgb(0 0 0 / 5%);
}

.c-title {
  padding-left: 10px;
  margin-bottom: 10px;
  font-size: 18px;
  color: #333;
  border-left: 4px solid #1bb4d4;
}

/* 追加ボタン */
.c-btn-add {
  width: 100%;
  padding: 12px;
  margin-bottom: 25px;
  font-size: 16px;
  font-weight: bold;
  color: #fff;
  cursor: pointer;
  background: #1bb4d4;
  border: none;
  border-radius: 8px;
  transition: 0.2s;
}

.c-btn-add:hover {
  opacity: 0.8;
}

/* リストとアイテム */
.c-list {
  display: flex;
  flex-direction: column;
  gap: 10px;
  margin-bottom: 30px;
}

.c-list__item {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 12px 15px;
  font-weight: bold;
  background: #f8f9fa;
  border: 1px solid #ddd;
  border-radius: 8px;
}

.c-item-text {
  font-size: 16px;
}

.c-btn-group {
  display: flex;
  gap: 8px;
}

.c-btn {
  padding: 6px 12px;
  font-size: 13px;
  font-weight: bold;
  color: #fff;
  cursor: pointer;
  border: none;
  border-radius: 6px;
  transition: 0.2s;
}

.c-btn:hover {
  opacity: 0.8;
}

.c-btn--remove {
  background: #dc3545;
}

.c-btn--child {
  background: #fd7e14;
}

/* ゴミ箱エリア */
.p-trash {
  padding: 20px;
  background: #fffdf5;
  border: 2px dashed #ffc107;
  border-radius: 8px;
}

.p-trash__desc {
  margin-bottom: 10px;
  font-size: 13px;
  color: #888;
}

.c-trash-box {
  padding: 15px;
  font-size: 16px;
  font-weight: bold;
  color: #fd7e14;
  text-align: center;
  background: #fff;
  border: 1px solid #eee;
  border-radius: 6px;
}

/* ゴミ箱に入ったアイテムからはボタンを隠す */
.c-trash-box .c-btn-group {
  display: none;
}

【JavaScript】

const list = document.querySelector('.js-list');
const addBtn = document.querySelector('.js-btn-add');
const trashBox = document.querySelector('.js-trash-box');
let itemCount = 2; // アイテムの連番管理用

// 💡 1. 新しいアイテムを追加する処理 (append)
addBtn.addEventListener('click', () => {
  itemCount++;
  const li = document.createElement('li');
  li.className = 'c-list__item';
  li.innerHTML = `
    <span class="c-item-text">アイテム ${itemCount}</span>
    <div class="c-btn-group">
      <button class="c-btn c-btn--remove js-remove">remove()</button>
      <button class="c-btn c-btn--child js-remove-child">removeChild()</button>
    </div>
  `;
  list.append(li);
});

// 💡 2. 削除ボタンの処理(後から追加した要素にも効くように、親の ul でクリックを監視!)
list.addEventListener('click', (event) => {
  // クリックされた要素を取得
  const target = event.target;
  // クリックされたボタンが属する「li要素」を closest() で特定!
  const listItem = target.closest('.c-list__item');
  if (!listItem) return;

  // パターンA:remove() ボタンが押された場合
  if (target.classList.contains('js-remove')) {
    // 要素自身に対して直接 .remove() を呼ぶだけでシンプルに消える!(返り値は undefined)
    listItem.remove();
  }

  // パターンB:removeChild() ボタンが押された場合
  if (target.classList.contains('js-remove-child')) {
    // 親要素(list)から見て、子要素(listItem)を指定して削除する。
    // 💡 返り値として「削除された要素そのもの」が返ってくるので、変数で受け取れる!
    const removedElement = list.removeChild(listItem);

    // 受け取った要素を「ゴミ箱エリア」に再利用(移動)して表示する!
    trashBox.innerHTML = ''; // ゴミ箱を一旦空にする
    trashBox.append(removedElement);
  }
});

コードの解説と2つの違い

違いその1:誰に対して命令するか(書き方の違い)

  • 要素.remove()
    削除したい要素「自身」に対して直接命令します。親要素を取得する必要がないため、コードが短く直感的です。
  • 親要素.removeChild(子要素)
    「親要素」に対して、「この子要素を削除してね」と命令します。もし親要素が変数として用意していない場合、item.parentNode.removeChild(item) のように一度親を辿る必要があります。

違いその2:返り値の有無(再利用できるか)

  • remove()
    返り値は undefinedです。ただシンプルに画面から削除したい時に使います。
  • removeChild()
    返り値として「削除した要素そのもの(Node)」を返します。
// パターンB:removeChild() ボタンが押された場合
if (target.classList.contains('js-remove-child')) {
  // 親要素(list)から見て、子要素(listItem)を指定して削除する。
  // 💡 返り値として「削除された要素そのもの」が返ってくるので、変数で受け取れる!
  const removedElement = list.removeChild(listItem);

  // 受け取った要素を「ゴミ箱エリア」に再利用(移動)して表示する!
  trashBox.innerHTML = ''; // ゴミ箱を一旦空にする
  trashBox.append(removedElement);
}

デモのように、const removedElement = list.removeChild(listItem); として変数で受け取っておけば、画面からは一度消えますがデータとしては生きているため、「元に戻す(Undo)機能」を作ったり、別のリストへそのまま移動させたりといった再利用ができます!

補足:追加された要素の削除ボタンの動作設定

// 💡 2. 削除ボタンの処理(後から追加した要素にも効くように、親の ul でクリックを監視!)
list.addEventListener('click', (event) => {
  // クリックされた要素を取得
  const target = event.target;
  // クリックされたボタンが属する「li要素」を closest() で特定!
  const listItem = target.closest('.c-list__item');
  if (!listItem) return;

  // パターンA:remove() ボタンが押された場合
  if (target.classList.contains('js-remove')) {
    ...
  }

  // パターンB:removeChild() ボタンが押された場合
  if (target.classList.contains('js-remove-child')) {
    ...
  }
});

デモのように後から append() で動的に追加した要素には、最初から個別にイベントを設定しておくことができません。そのため、親要素である <ul>(list)自体にクリックイベントを設定し、event.target と closest() を組み合わせて「どのアイテムの削除ボタンが押されたか」を判定する手法(イベント委譲)を使うのが鉄板パターンです!

補足:公式ドキュメント

・MDN: remove()
・MDN: removeChild()

まとめ

今回はDOM要素を削除する remove() と removeChild() の違いについて解説しました。

単なる要素の削除であれば、記述がシンプルな remove() を使うのが現代のスタンダードです。一方で、削除した要素のデータをそのまま受け取って別の場所に移したり、履歴として保持したいといった特別なケースでは removeChild() の返り値が非常に役立ちます。

以前紹介した「追加」メソッドと今回の「削除」メソッドを組み合わせれば、ToDoリストのような動的なWebアプリも自在に作れるようになるので、ぜひセットでマスターしてみてくださいね!

Prev
Next