初回アクセス時のみ表示するモーダルウインドウの作り方【HTML/CSS/JavaScript・サンプルコード付き】

<!DOCTYPE html>
<html lang="ja">
<head>

  <!-- 文字コード -->
  <meta charset="UTF-8">

  <!-- スマートフォン対応 -->
  <meta name="viewport" content="width=device-width, initial-scale=1.0">

  <!-- ページタイトル -->
  <title>初回アクセス時のみ表示するモーダルウインドウ</title>

  <!-- CSSファイル -->
  <link rel="stylesheet" href="style.css">

</head>
<body>

  <!-- デモ表示エリア -->
  <div class="first-visit-modal-window_wrap">

    <!-- タイトル -->
    <div class="first-visit-modal-window_title">
      初回アクセス時のみ表示
    </div>

    <!-- 説明文 -->
    <p class="first-visit-modal-window_text">
      初めてページを開いたときだけ、モーダルウインドウを自動で表示します。一度「閉じる」をクリックするとブラウザのlocalStorageに状態が保存され、ページを再読み込みしても表示されません。もう一度初回表示を確認する場合は、localStorageに保存された「firstVisitModalWindowClosed」を削除してからページを再読み込みしてください。
    </p>

  </div>

  <!-- 初回アクセス時に表示するモーダルウインドウ -->
  <div class="first-visit-modal-window_modal" id="first-visit-modal-window-modal" role="dialog" aria-modal="true" aria-labelledby="first-visit-modal-window-title">

    <!-- モーダルタイトル -->
    <div class="first-visit-modal-window_modal-title" id="first-visit-modal-window-title">
      はじめての方へ
    </div>

    <!-- モーダル説明文 -->
    <p class="first-visit-modal-window_modal-text">
      このモーダルウインドウは、初回アクセス時のみ表示されます。
    </p>

    <!-- 閉じるボタン -->
    <button class="first-visit-modal-window_close" id="first-visit-modal-window-close" type="button">
      閉じる
    </button>

  </div>

  <!-- JavaScriptファイル -->
  <script src="script.js"></script>

</body>
</html>

/* ページ全体 */
body{
  margin:0; /* ブラウザ標準の外側余白を削除 */
  padding:40px 20px; /* 上下40px・左右20px。値を大きくすると画面端との間隔が広がる */
  background:#fff; /* ページ全体の背景色 */
  color:#111827; /* ページ全体の基本文字色 */
  font-family:sans-serif; /* ページ全体で使用するフォント */
}

/* デモ表示エリア */
.first-visit-modal-window_wrap{
  max-width:700px; /* 最大横幅。値を大きくすると表示エリアが横に広がる */
  margin:40px auto; /* 上下40pxの余白を付けて左右中央へ配置 */
  padding:32px; /* 内側余白。値を大きくすると内容と枠線の間隔が広がる */
  border:1px solid #e5e7eb; /* 表示エリアを囲む枠線 */
  border-radius:18px; /* 角丸。値を大きくすると丸みが強くなる */
  background:#f8fafc; /* 表示エリアの背景色 */
  text-align:center; /* 内容を中央揃えにする */
  box-sizing:border-box; /* paddingとborderを横幅へ含める */
}

/* タイトル */
.first-visit-modal-window_title{
  margin:0 0 12px; /* 下側12pxの余白。値を大きくすると説明文との間隔が広がる */
  font-size:22px; /* タイトルの文字サイズ。値を大きくすると文字が大きくなる */
  font-weight:700; /* タイトルを太字にする */
}

/* 説明文 */
.first-visit-modal-window_text{
  margin:0; /* 外側余白を削除 */
  color:#4b5563; /* 説明文の文字色 */
  line-height:1.8; /* 行間。値を大きくすると行間が広がる */
}

/* モーダルウインドウ */
.first-visit-modal-window_modal{
  display:none; /* 初期状態では非表示 */
  position:fixed; /* 画面を基準に固定 */
  top:50%; /* 上端を画面中央へ配置 */
  left:50%; /* 左端を画面中央へ配置 */
  z-index:9999; /* 他の要素より前面へ表示 */
  width:calc(100% - 40px); /* 画面左右に合計40px分の余白を確保 */
  max-width:420px; /* 最大横幅。値を大きくするとモーダルが横に広がる */
  padding:28px; /* 内側余白。値を大きくすると内容と外周の間隔が広がる */
  border-radius:18px; /* 角丸。値を大きくすると丸みが強くなる */
  background:#fff; /* モーダルの背景色 */
  box-shadow:0 20px 40px rgba(0,0,0,.2); /* 20pxは縦方向、40pxはぼかし範囲 */
  text-align:center; /* モーダル内を中央揃えにする */
  box-sizing:border-box; /* paddingを横幅へ含める */
  transform:translate(-50%,-50%); /* モーダル自身の半分だけ戻して中央配置 */
}

/* モーダル表示時 */
.first-visit-modal-window_modal.is-active{
  display:block; /* モーダルを表示 */
}

/* モーダルタイトル */
.first-visit-modal-window_modal-title{
  margin:0 0 12px; /* 下側12pxの余白。値を大きくすると説明文との間隔が広がる */
  font-size:22px; /* タイトルの文字サイズ。値を大きくすると文字が大きくなる */
  font-weight:700; /* タイトルを太字にする */
}

/* モーダル説明文 */
.first-visit-modal-window_modal-text{
  margin:0 0 24px; /* 下側24pxの余白。値を大きくすると閉じるボタンとの間隔が広がる */
  color:#4b5563; /* 説明文の文字色 */
  line-height:1.8; /* 行間。値を大きくすると行間が広がる */
}

/* 閉じるボタン */
.first-visit-modal-window_close{
  padding:10px 20px; /* 上下10px・左右20px。値を大きくするとボタンが大きくなる */
  border:none; /* 枠線を非表示 */
  border-radius:8px; /* 角丸。値を大きくすると丸みが強くなる */
  background:#111827; /* ボタンの背景色 */
  color:#fff; /* ボタンの文字色 */
  font-weight:700; /* ボタン文字を太字にする */
  cursor:pointer; /* マウスカーソルをポインターにする */
}

/* 画面幅640px以下 */
@media (max-width:640px){

  /* デモ表示エリア */
  .first-visit-modal-window_wrap{
    padding:24px 18px; /* スマートフォンでは内側余白を小さくする */
  }

  /* モーダルウインドウ */
  .first-visit-modal-window_modal{
    padding:24px 18px; /* スマートフォンではモーダルの内側余白を小さくする */
  }

}

// モーダルウインドウを取得
const firstVisitModalWindowModal =
  document.getElementById("first-visit-modal-window-modal");

// 閉じるボタンを取得
const firstVisitModalWindowClose =
  document.getElementById("first-visit-modal-window-close");

// 初回表示を判定するlocalStorageのキー
const firstVisitModalWindowKey =
  "firstVisitModalWindowClosed";

// 保存された状態を確認
if(localStorage.getItem(firstVisitModalWindowKey)!=="true"){

  // 閉じた記録がない場合だけモーダルを表示
  firstVisitModalWindowModal.classList.add("is-active");

}

// 閉じるボタンをクリックしたとき
firstVisitModalWindowClose.addEventListener("click", () => {

  // モーダルを非表示
  firstVisitModalWindowModal.classList.remove("is-active");

  // 閉じた状態をブラウザへ保存
  localStorage.setItem(
    firstVisitModalWindowKey,
    "true"
  );

});