HOWTO · JavaScript

JavaScript でウェブページの中央に div 要素をポップアップ表示する

このチュートリアルでは、Web ページの中央にポップアップを開くように設定する方法を紹介します。

このページの内容

中央配置のポップアップを使うと、現在のページの上に、伝えたいメッセージや操作を表示できます。この例では、ページ全体を覆うオーバーレイと独立したダイアログパネルを使い、JavaScript で表示と非表示を切り替える方法を紹介します。ポップアップが自動的にモーダルになるわけではありません。「モーダル」とは、ユーザーが応答するまでページのほかの部分を操作できない仕組みを指します。

ポップアップとは

ポップアップはページ内容の上に表示する小さなパネルで、短いメッセージの提示、確認の依頼、簡潔な回答の入力などによく使われます。この例では、暗くしたオーバーレイが表示領域を覆い、その中央に白いパネルを配置します。両者を別々の要素にすると、オーバーレイで背景を覆い、パネルに内容を表示できます。

ポップアップのスタイルを設定して中央に配置する

スクロール中も表示領域全体を覆うには、固定配置のオーバーレイを使います。固定のパーセント位置ではなくCSS Gridでパネルを中央に配置します。min() を使えば、読みやすい最大幅を保ちながら、狭い画面にも収まるようにできます。オーバーレイは初期状態では非表示で、通常のページ内容より大きい z-index を指定して前面に重ねます。

このセクションのコードと表示されるラベルや出力は英語のままです。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Centered popup</title>
  <style>
    .overlay {
      position: fixed;
      inset: 0;
      display: none;
      place-items: center;
      padding: 1rem;
      background: rgb(0 0 0 / 65%);
      z-index: 1000;
    }
    .popup {
      width: min(100%, 32rem);
      padding: 1.5rem;
      background: white;
      color: #222;
      border-radius: 0.5rem;
      box-shadow: 0 1rem 3rem rgb(0 0 0 / 25%);
    }
    .popup h2 { margin-top: 0; }
  </style>
</head>
<body>
  <button id="open-popup" type="button">Show popup</button>
  <div class="overlay" id="overlay">
    <section class="popup" aria-labelledby="popup-title">
      <button id="close-popup" type="button">Close</button>
      <h2 id="popup-title">Popup content</h2>
      <p>This panel is centered over the page.</p>
    </section>
  </div>
</body>
</html>

オーバーレイ自体が画面全体を覆うレイヤーで、ダイアログパネルはその中に中央配置する子要素です。オーバーレイに display: grid を設定すると place-items: center が有効になり、display: none にすると、表示するまでレイアウトから除外されます。パネルの幅に指定した min() により、左右に1remの余白を保って利用可能な幅に収まります。ほかのページ要素がより高いスタッキングレイヤーを作る場合は、z-index を調整してください。

JavaScript でポップアップを開閉する

オーバーレイの display を grid にすると表示され、none に戻すと非表示になります。次のコードは、HTML例と同じIDを使います。ブラウザーの document がない環境でも状態の変更を例示できるよう、小さな代替オブジェクトを用意しています。ページ上では、要素をDOMから取得します。

この例を実行してください。

このセクションのコードと表示されるラベルや出力は英語のままです。

const overlay = typeof document === "undefined"
  ? { style: { display: "none" } }
  : document.getElementById("overlay");

function OpenModal() {
  overlay.style.display = "grid";
}

function CloseModal() {
  overlay.style.display = "none";
}

OpenModal();
console.log(overlay.style.display);
CloseModal();
console.log(overlay.style.display);

ページ上の操作ボタンとつなぐには、表示ボタンが操作されたときに OpenModal を、閉じるボタンが操作されたときに CloseModal を呼び出します。たとえば、document.getElementById("open-popup").addEventListener("click", OpenModal) を追加し、close-popup にも同様のイベントリスナーを設定します。これは表示状態を変えるだけです。本番用のダイアログでは、キーボード操作やフォーカス管理、Escapeキーで閉じる方法も必要になる場合があります。

jQuery でポップアップを開閉する

プロジェクトですでに jQuery を使っている場合は、その show() と hide() メソッドでオーバーレイの表示状態を変更できます。このコードを実行する前に jQuery を読み込むかインストールし、HTMLと同じ overlay IDを使ってください。

このセクションのコードと表示されるラベルや出力は英語のままです。

function OpenModal() {
  $("#overlay").show();
}

function CloseModal() {
  $("#overlay").hide();
}

show() は jQuery が管理する display: none を解除し、要素を表示できるようにします。hide() は display: none を設定します。上のCSSでは中央配置にGridを使っているため、jQuery の既定の表示状態への復元では、環境によってそのレイアウトが保たれないことがあります。必要なら、表示時に $("#overlay").css("display", "grid") を明示的に設定してください。これらのメソッドが変更するのは display です。CSSの visibility: hidden で隠した要素を表示するものではありません。