WordPressの画像をクリックで拡大するlightboxのようなコード

WordPressの画像拡大機能を追加するプラグインはたくさんありますが、今回は画像拡大機能を自作してみましたのでメモします。

See the Pen 自作lightboxで拡大 by hiro (@hirochanpon) on CodePen.

こちらの画像ですが、クリックすると拡大します。

まず、HTMLにこちらのコードを埋め込みます。×マークで閉じる機能を付けています。

<!-- ライトボックス用オーバーレイ -->
<div id="lightbox-overlay">
  <button id="lightbox-close" aria-label="閉じる">×</button>
  <img id="lightbox-image" src="" alt="">
</div>

それから、CSSを書きます。

/* ライトボックスの背景 */
#lightbox-overlay {
  position: fixed;
  inset: 0;
  background: rgba(0, 0, 0, 0.85);
  display: flex;
  justify-content: center;
  align-items: center;
  visibility: hidden;
  opacity: 0;
  transition: opacity .25s ease;
  z-index: 9999;
}

/* 画像 */
#lightbox-image {
  max-width: 90vw;
  max-height: 90vh;
  border-radius: 6px;
  box-shadow: 0 0 20px rgba(0,0,0,0.5);
}

/* 表示状態 */
#lightbox-overlay.active {
  visibility: visible;
  opacity: 1;
  cursor: zoom-out;
}

/* 画像に選択防止 */
.wp-block-image img {
  cursor: zoom-in;
}
/* 閉じるボタン */
#lightbox-close {
  position: absolute;
  top: 20px;
  right: 20px;
  font-size: 32px;
  color: #fff;
  background: transparent;
  border: none;
  cursor: pointer;
  z-index: 10000;
  padding: 0;
  line-height: 1;
}

#lightbox-close:hover {
  opacity: 0.7;
}

JSです。ESCキーで拡大した画面が閉じる仕様になっています。

document.addEventListener("DOMContentLoaded", function () {

  const overlay = document.getElementById("lightbox-overlay");
  const lightboxImg = document.getElementById("lightbox-image");

  // ★ no-lightbox を除外した画像だけを対象にする
  const images = document.querySelectorAll(".wp-block-image img:not(.no-lightbox)");

  // クリックでライトボックスを開く
  images.forEach(img => {
    img.addEventListener("click", () => {
      lightboxImg.src = img.src;
      overlay.classList.add("active");
    });
  });

  // オーバーレイクリックで閉じる
  overlay.addEventListener("click", () => {
    overlay.classList.remove("active");
    lightboxImg.src = "";
  });

  // Escキーで閉じる
  document.addEventListener("keydown", (e) => {
    if (e.key === "Escape") {
      overlay.classList.remove("active");
      lightboxImg.src = "";
    }
  });

});

拡大したくない画像がある場合は、画像に.no-lightboxというクラスをつけてください。これを付けた画像は拡大されません。

以上です～。