【JavaScript】モーダルウィンドウの作り方!背景クリックで閉じる処理や背面スクロール禁止の実装デモ

画像や詳細テキスト、入力フォームなどを画面の上にポップアップ表示させる「モーダルウィンドウ」は、Webサイト制作における必須UIパーツのひとつです。 近年ではHTMLの <dialog> 要素を使った実装も増えていますが、既存のプロジェクトや自由度の高いカスタマイズを行う現場では、従来の <div> 要素とクラスの付け替えによる実装 が今も多く使われています。

モーダルを自作する際は、ただ要素を表示するだけでなく、「モーダルの外側(暗い背景部分)をクリックしたら閉じる」「開いている間は後ろのページがスクロールしないようにロックする(モーダル内のスクロールは許可する)」といった細かな制御が重要になります。

今回は、これらの必須機能をすべて備えたシンプルで汎用性の高いモーダルウィンドウの実装方法と、注意すべきポイントをデモと一緒に分かりやすく解説します!

デモ動作

See the Pen Untitled by mikanbako (@mikanbako) on CodePen.

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

実装コード紹介

【HTML】

<!-- 背面のページコンテンツ(スクロール確認用に高さを確保) -->
<div class="l-page">
  <div class="l-wrap">
    <h2>シンプル&実用的なモーダルウィンドウ実装デモ</h2>
    <p class="p-desc">モーダルを開いた状態で、「画面のスクロール操作」「黒い背景部分のクリック」「Escキー」を試してみてね!</p>

    <div class="p-card">
      <p>👇 下のボタンをクリックするとモーダルが開きます</p>
      <!-- data-modal-open に開きたいモーダルの id を指定 -->
      <button class="c-btn-open js-modal-open" data-modal-open="modal-sample" type="button">
        モーダルウィンドウを開く
      </button>
    </div>

    <!-- 背面スクロール確認用のダミーブロック -->
    <div class="p-dummy-scroll">
      <p>🔽 ここは背面のページコンテンツです(下へスクロールできます)</p>
      <p>モーダルが開いている間は、<code>body</code> に <code>overflow: hidden;</code> が付与されるため、この背面ページはスクロールできなくなります!</p>
      <p>🔽 スクロール確認用ダミーテキスト 🔽</p>
    </div>
  </div>
</div>

<!-- 💡 モーダルウィンドウ本体(初期状態は非表示) -->
<div id="modal-sample" class="c-modal js-modal" aria-hidden="true">
  <!-- モーダルの白いボックス(内側) -->
  <div class="c-modal__content" role="dialog" aria-modal="true" aria-labelledby="modal-title">
    
    <!-- ヘッダー -->
    <div class="c-modal__header">
      <h3 id="modal-title" class="c-modal__title">✨ モーダルウィンドウのタイトル</h3>
      <button class="c-modal__close-icon js-modal-close" type="button" aria-label="閉じる">×</button>
    </div>

    <!-- ボディ(長文の時はここだけスクロール可能にする!) -->
    <div class="c-modal__body">
      <p><strong>【チェックしてみよう!】</strong></p>
      <ul>
        <li>✅ 外側の黒い半透明エリア(オーバーレイ)をクリックすると閉じます。</li>
        <li>✅ 白いボックスの中をクリックしても閉じません。</li>
        <li>✅ キーボードの <code>Esc</code> キーを押しても閉じます。</li>
        <li>✅ 背面のページはスクロール禁止になっていますが、<strong>この白いボックスの中は下にスクロールできます👇</strong></li>
      </ul>
      <div class="c-modal__scroll-demo">
        <p>--- モーダル内スクロール確認エリア ---</p>
        <p>モーダルの中の文章が長い場合、<code>.c-modal__body</code> に <code>overflow-y: auto;</code> を設定しておくことで、モーダル内部だけをスクロールさせることができます。</p>
        <p>1. ダミーテキスト...</p>
        <p>2. ダミーテキスト...</p>
        <p>3. ダミーテキスト...</p>
        <p>🎉 モーダル内の一番下までスクロールできました!</p>
      </div>
    </div>

    <!-- フッター -->
    <div class="c-modal__footer">
      <button class="c-btn-close js-modal-close" type="button">閉じる</button>
    </div>

  </div>
</div>

【CSS】

/* 💡 重要:モーダル表示中に body に付与して背面スクロールを禁止するクラス */
body.is-scroll-lock {
  overflow: hidden;
}

.l-page {
  padding: 40px 20px 120px;
  text-align: center;
}

.l-wrap {
  max-width: 600px;
  margin: 0 auto;
}

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

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

.p-card {
  padding: 30px;
  margin-bottom: 30px;
  font-size: 16px;
  font-weight: bold;
  background: #fff;
  border-radius: 12px;
  box-shadow: 0 4px 15px rgb(0 0 0 / 5%);
}

.c-btn-open {
  margin-top: 20px;
  padding: 14px 28px;
  font-family: inherit;
  font-size: 16px;
  font-weight: bold;
  color: #fff;
  cursor: pointer;
  background: #1bb4d4;
  border: none;
  border-radius: 8px;
  transition: 0.2s;
}

.c-btn-open:hover {
  opacity: 0.85;
  transform: translateY(-2px);
}

.p-dummy-scroll {
  display: flex;
  flex-direction: column;
  gap: 30vh;
  padding: 40px 20px;
  font-size: 16px;
  font-weight: bold;
  color: #555;
  background: #e9ecef;
  border: 2px dashed #adb5bd;
  border-radius: 12px;
}

/* =========================================
   💡 モーダルウィンドウのスタイル
========================================= */

/* 1. 外側のオーバーレイ(画面全体を覆う黒い半透明の背景) */
.c-modal {
  position: fixed;
  top: 0;
  left: 0;
  z-index: 1000;
  box-sizing: border-box;
  display: flex;
  align-items: center;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 20px;
  background: rgb(0 0 0 / 60%);

  /* 初期状態は透明&クリック不可にして隠しておく(transitionを効かせるため) */
  visibility: hidden;
  opacity: 0;
  transition:
    opacity 0.3s ease-out,
    visibility 0.3s ease-out;
}

/* ⭕ 開いた状態(.is-open 付与時) */
.c-modal.is-open {
  visibility: visible;
  opacity: 1;
}

/* 2. モーダル内側の白いボックス */
.c-modal__content {
  display: flex;
  flex-direction: column;
  width: 100%;
  max-width: 500px;

  /* 画面の高さからはみ出さないように最大高さを制限 */
  max-height: 85vh;
  overflow: hidden;
  background: #fff;
  border-radius: 12px;
  box-shadow: 0 10px 30px rgb(0 0 0 / 20%);
  transform: translateY(15px);
  transition: transform 0.3s ease-out;
}

.c-modal.is-open .c-modal__content {
  transform: translateY(0);
}

/* ヘッダー・ボディ・フッター */
.c-modal__header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 16px 20px;
  border-bottom: 1px solid #eee;
}

.c-modal__title {
  font-size: 16px;
  color: #1bb4d4;
}

.c-modal__close-icon {
  padding: 0 4px;
  font-size: 24px;
  line-height: 1;
  color: #888;
  cursor: pointer;
  background: none;
  border: none;
}

.c-modal__close-icon:hover {
  color: #333;
}

/* 💡 重要:中身が長い時はこのボディ部分だけを縦スクロールさせる! */
.c-modal__body {
  padding: 20px;
  overflow-y: auto;
  font-size: 14px;
  line-height: 1.6;
  text-align: left;
}

.c-modal__body ul {
  padding-left: 20px;
  margin-top: 8px;
}

.c-modal__body code {
  padding: 2px 6px;
  font-size: 14px;
  font-weight: bold;
  color: #e83e8c;
  background: #f1f3f5;
  border-radius: 4px;
}

.c-modal__scroll-demo {
  display: flex;
  flex-direction: column;
  gap: 10vh;
  padding: 15px;
  margin-top: 15px;
  font-size: 14px;
  background: #f8f9fa;
  border: 1px solid #dee2e6;
  border-radius: 8px;
}

.c-modal__footer {
  padding: 12px 20px;
  text-align: right;
  background: #fafafa;
  border-top: 1px solid #eee;
}

.c-btn-close {
  padding: 8px 20px;
  font-family: inherit;
  font-size: 16px;
  font-weight: bold;
  color: #fff;
  cursor: pointer;
  background: #6c757d;
  border: none;
  border-radius: 6px;
}

.c-btn-close:hover {
  background: #5a6268;
}

【JavaScript】

const openButtons = document.querySelectorAll('.js-modal-open');
const modals = document.querySelectorAll('.js-modal');

// 💡 1. モーダルを開く関数
const openModal = (modal) => {
  if (!modal) return;
  modal.classList.add('is-open');
  modal.setAttribute('aria-hidden', 'false');
  // 背面ページのスクロールを禁止する
  document.body.classList.add('is-scroll-lock');
};

// 💡 2. モーダルを閉じる関数
const closeModal = (modal) => {
  if (!modal) return;
  modal.classList.remove('is-open');
  modal.setAttribute('aria-hidden', 'true');
  // 背面ページのスクロール禁止を解除する
  document.body.classList.remove('is-scroll-lock');
};

// 開くボタンのクリックイベント
openButtons.forEach(btn => {
  btn.addEventListener('click', () => {
    const targetId = btn.dataset.modalOpen;
    const targetModal = document.getElementById(targetId);
    openModal(targetModal);
  });
});

// 各モーダル内の「閉じる処理」の設定
modals.forEach(modal => {
  // 「×ボタン」や「閉じるボタン」をクリックした時に閉じる
  const closeButtons = modal.querySelectorAll('.js-modal-close');
  closeButtons.forEach(btn => {
    btn.addEventListener('click', () => closeModal(modal));
  });

  // モーダルの外側(黒いオーバーレイ部分)をクリックした時に閉じる!
  modal.addEventListener('click', (e) => {
    // クリックされた要素(e.target)が、内側の白いボックスではなく
    // 一番外側の .c-modal(オーバーレイ自身)だった場合のみ閉じる!
    if (e.target === modal) {
      closeModal(modal);
    }
  });
});

// キーボードの「Escape(Esc)キー」が押された時に開いているモーダルを閉じる
document.addEventListener('keydown', (e) => {
  if (e.key === 'Escape') {
    const activeModal = document.querySelector('.js-modal.is-open');
    if (activeModal) {
      closeModal(activeModal);
    }
  }
});

モーダル実装の重要ポイントと注意点

ポイント①:開閉アニメーションには opacity と visibility を使う

display: none; と display: block; で表示を切り替えると transition(ふわっと表示・非表示にするアニメーション)が効きません。

そのため、初期状態を opacity: 0; visibility: hidden; にしておき、.is-open クラスが付いた時に opacity: 1; visibility: visible; に切り替えるのが鉄則です! (opacity: 0 だけだと、透明なまま画面の上に残り続けて背面のボタンがクリックできなくなってしまうため、必ず visibility: hidden とセットで使います。)

/* =========================================
   💡 モーダルウィンドウのスタイル
========================================= */
.c-modal {
  ...
  
  /* 初期状態は透明&クリック不可にして隠しておく(transitionを効かせるため) */
  opacity: 0;
  visibility: hidden;
  transition: opacity 0.3s ease-out, visibility 0.3s ease-out;
}

/* 開いた状態(.is-open 付与時) */
.c-modal.is-open {
  opacity: 1;
  visibility: visible;
}

ポイント②:外側(オーバーレイ)クリックで閉じる仕組み(e.target === modal)

「外側の黒い背景をクリックしたら閉じるけれど、内側の白いボックスをクリックしても閉じないようにする」という処理は、イベントオブジェクトの e.target を使うと判定できます!

modal.addEventListener('click', (e) => {
  // 実際にクリックされた要素(e.target)がオーバーレイ(modal自身)と一致する時だけ閉じる!
  if (e.target === modal) {
    closeModal(modal);
  }
});

白いボックス自体やボックス内のテキストやボタンをクリックした時は、e.target がその内部要素になるため e.target === modal が false となり、誤って閉じてしまうのを防ぐことができます。

ポイント③:背面スクロール禁止と「モーダル内スクロール」の両立

モーダルが開いている時にマウスホイールを回して後ろのページが動いてしまうと、非常に操作しづらくなります。これを防ぐには以下の2つのCSSを組み合わせます。

  1. 背面のロック
    モーダルを開いた時に document.body.classList.add('is-scroll-lock') を実行し、body に対して overflow: hidden; を適用してページ全体のスクロールを止めます。
  2. モーダル内のスクロール許可
    モーダルの白いボックス(.c-modal__content)に max-height を指定し、テキストが入る .c-modal__body に overflow-y: auto; を指定します。

これで「後ろの画面は留まり(スクロール禁止)、モーダルの中の長い文章はスクロールできる」という挙動が実装できます!

ポイント④:keydown イベントで Escape キーでも閉じられるように配慮する

ユーザビリティの観点から、モーダルウィンドウをEscape キーでも閉じられるように配慮することも重要です!keydownイベントにて、Escape キー押下時に開かれているモーダルウィンドウを閉じる処理を実装しましょう!

// キーボードの「Escape(Esc)キー」が押された時に開いているモーダルを閉じる
document.addEventListener('keydown', (e) => {
  if (e.key === 'Escape') {
    const activeModal = document.querySelector('.js-modal.is-open');
    if (activeModal) {
      closeModal(activeModal);
    }
  }
});

補足(注意点):PCでの「スクロールバー消失による画面のガタつき」対策

body に overflow: hidden; を指定した際、Windowsなどの画面右側に常にスクロールバーが表示されている環境では、「スクロールバーが消えた分(約15px〜17px)だけ画面の横幅が広がり、背景のレイアウトが右にガタッとズレる」という現象が起きることがあります。

これが気になる場合は、近年のモダンCSSである scrollbar-gutter: stable; を html 要素に指定しておくか、JSでスクロールバーの幅を計算して body の padding-right に補填するといった対策を行うと、より完璧な品質になります!

/* スクロールバーが表示・非表示になっても領域を確保してガタつきを防ぐモダンCSS */
html {
  scrollbar-gutter: stable;
}

補足:公式ドキュメント

・MDN: scrollbar-gutter

まとめ

今回はWeb制作の定番UIである「モーダルウィンドウ」の仕組みと実装方法について解説しました。

  • 表示・非表示:opacity と visibility を組み合わせて滑らかにフェードさせる
  • 外側クリック判定:if (e.target === modal) でオーバーレイ部分のクリックだけを検知する
  • スクロール制御:body に overflow: hidden を付けて背面を止め、モーダル内部に overflow-y: auto を設定する
  • ユーザビリティ:keydown イベントで Escape キーでも閉じられるように配慮する

これらの基本設計を押さえておけば、画像ギャラリーやお問い合わせフォームの確認画面など、あらゆる場面で使いやすいモーダルUIが作れるようになります。ぜひまずはこのモーダルUIの基本形をマスターしてみてください!

Prev
Next