【JavaScript】親・祖先要素を探す!closest()メソッドの使い方と活用デモ

JavaScriptでDOM操作をしていると、クリックされたボタンそのものではなく、「そのボタンを包んでいる親要素(カードや行全体)」に対して何か処理をしたい場面が多々あります。 例えば、複数の商品が並ぶショッピングカートで「削除ボタン」を押した時、そのボタンがある「商品1行まるごと(親要素)」を消し去るようなケースです。

こういう時、安易に .parentElement を重ねて .parentElement.parentElement のように書いてしまうと、HTMLの構造が少し変わっただけで動かなくなってしまいます。

そこで活躍するのが、指定したセレクタに一致する最も近い親・祖先要素を自動で探してくれる closest() メソッドです! 今回は、「カード型リストの個別削除デモ」と一緒に、その便利な使い方とメリットを解説します!

デモ動作

See the Pen closest()で親・祖先要素を探す! by mikanbako (@mikanbako) on CodePen.

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

実装コード紹介

【HTML】

<div class="l-wrap">
  <h2>closest() 削除機能デモ</h2>
  <p class="p-desc">「削除する」ボタンを押すと、ボタンが所属している「カード全体(親要素)」をclosest()で特定して削除します!</p>
  
  <div class="p-demo-box">
    <!-- ショッピングカート内の商品リスト -->
    <div class="c-cart">
      
      <!-- 商品1(この要素を丸ごと削除したい) -->
      <div class="c-cart-item js-cart-item">
        <div class="c-cart-info">
          <span class="c-cart-icon">🍎</span>
          <div>
            <div class="c-cart-name">りんご</div>
            <div class="c-cart-price">150円</div>
          </div>
        </div>
        <!-- 💡 このボタンが押されたとき、一番近い .js-cart-item を探します -->
        <button class="c-btn-delete js-btn-delete">🗑️ 削除する</button>
      </div>

      <!-- 商品2 -->
      <div class="c-cart-item js-cart-item">
        <div class="c-cart-info">
          <span class="c-cart-icon">🍌</span>
          <div>
            <div class="c-cart-name">ばなな</div>
            <div class="c-cart-price">200円</div>
          </div>
        </div>
        <button class="c-btn-delete js-btn-delete">🗑️ 削除する</button>
      </div>

      <!-- 商品3 -->
      <div class="c-cart-item js-cart-item">
        <div class="c-cart-info">
          <span class="c-cart-icon">🍇</span>
          <div>
            <div class="c-cart-name">ぶどう</div>
            <div class="c-cart-price">400円</div>
          </div>
        </div>
        <button class="c-btn-delete js-btn-delete">🗑️ 削除する</button>
      </div>

    </div>
  </div>
</div>

【CSS】

.l-wrap {
  padding: 40px 20px;
  max-width: 500px;
  margin: 0 auto;
  text-align: center;
  color: #3e3e3e;
}

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

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

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

/* カートアイテムの装飾 */
.c-cart {
  display: flex;
  flex-direction: column;
  gap: 15px;
}

.c-cart-item {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 16px;
  background: #f8f9fa;
  border: 1px solid #ddd;
  border-radius: 8px;
  transition: all 0.3s ease;
}

/* 削除時(非表示)のアニメーション用クラス */
.is-deleted {
  pointer-events: none;
  opacity: 0;
  transform: scale(0.9);
}

.c-cart-info {
  display: flex;
  gap: 15px;
  align-items: center;
  text-align: left;
}

.c-cart-icon {
  font-size: 32px;
}

.c-cart-name {
  font-size: 16px;
  font-weight: bold;
}

.c-cart-price {
  font-size: 14px;
  color: #666;
}

/* 削除ボタン */
.c-btn-delete {
  padding: 8px 12px;
  font-size: 16px;
  font-weight: bold;
  color: #dc3545;
  cursor: pointer;
  background: #fff;
  border: 1.5px solid #dc3545;
  border-radius: 6px;
  transition: 0.3s;
}

.c-btn-delete:hover {
  color: #fff;
  background: #dc3545;
}

【JavaScript】

// すべての削除ボタンを取得
const deleteButtons = document.querySelectorAll('.js-btn-delete');

deleteButtons.forEach(btn => {
  btn.addEventListener('click', (event) => {
    // 💡 event.currentTarget(クリックされたボタン)から、
    // 上方向(祖先)に向かって、最も近い '.js-cart-item' クラスを持つ要素を探す!
    const cartItem = event.currentTarget.closest('.js-cart-item');
    
    // 見つかった親要素(カード全体)に、削除用のアニメーションクラスを付与
    if (cartItem) {
      cartItem.classList.add('is-deleted');
      
      // アニメーションが終わったら要素をDOMから完全に削除する
      setTimeout(() => {
        cartItem.remove();
      }, 300); // 0.3秒後に削除
    }
  });
});

コードの解説・メリット

.closest() とは?

element.closest('セレクタ') は、その要素自身からスタートして、HTMLのツリー(親要素、そのまた親要素…)を上方向(祖先)に向かって順番に探索し、指定したセレクタに一致する「最も近い」祖先要素を1つだけ取得するメソッドです。一致するものがなければ null を返します。

なぜ .parentElement ではダメなのか?

もし今回のデモで closest() ではなく、以下のように親要素を遡ろうとしたとします。

// ボタンの「親の親」のカード要素を取得しようとする例
const cartItem = btn.parentElement.parentElement;

これでも一見動きそうですが、もしデザイン変更でボタンの周りに新しい <div>(装飾用の枠など)が1つ追加されただけで、parentElement の階層がズレてしまい、全く違う要素を取得するかエラーになってしまいます。

一方で closest('.js-cart-item') を使っておけば、間にどれだけ新しい要素やタグが挟まっても、「とにかく上にある .js-cart-item を探す」という指示になるため、HTMLの構造変化に強い、バグが起きにくい頑丈なコードを書くことができます!

補足:公式ドキュメント

・MDN: closest()

まとめ

今回は、親・祖先要素を直感的に取得できる closest() メソッドをご紹介しました。

クリックされたボタンが「どの行やカードに属しているか」を特定する際、これほど頼もしいメソッドはありません。

HTMLの構造変化に強い頑丈なコードを書くためにも、単純な .parentElement で無理やり親を遡るのではなく、ぜひ closest() を積極的に活用してみてくださいね!

Prev
Next