こんにちは。今回はモーダルウィンドウの作り方を徹底的に解説していきます。
この記事は僕が書いている5歳でも分かるシリーズの1つです。こちらにスライドショーやタブメニューなどの作り方も載っていますのでぜひご覧ください。
「htmlはデータの構造」「cssはその見せ方を作るもの」「jsはクラスの付け替えによってその2つを操作するもの」と言う切り分け方を前提に、jQueryのaddClass/removeClass/toggleClassを用いた方法で実装します。
作るものの確認
今回作るのは、このように右上のボタンを押すと開閉するモーダルウィンドウです。

コードは以下のものになりますので、何か困ったことが起きたらここのコードと見比べてみてください。(コピペでも使えます)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 |
<!DOCTYPE html> <html lang="ja"> <head> <meta charset="UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Document</title> <link rel="stylesheet" href="./resources/styles/destyle.css" /> <link rel="stylesheet" href="./resources/styles/style.css" /> </head> <body> <header class="Header"> <h1 class="Logo">LOGO</h1> </header> <div class="Modal">モーダルウィンドウです</div> <div class="Overlay"></div> <main class="Main"> <section class="Section"><button class="Button">ボタン</button></section> <section class="Section"><button class="Button">ボタン</button></section> <section class="Section"><button class="Button">ボタン</button></section> <section class="Section"><button class="Button">ボタン</button></section> <section class="Section"><button class="Button">ボタン</button></section> <section class="Section"><button class="Button">ボタン</button></section> <section class="Section"><button class="Button">ボタン</button></section> </main> <script src="https://code.jquery.com/jquery-3.6.0.slim.min.js" integrity="sha256-u7e5khyithlIdTpu22PHhENmPcRdFiHRjhAuHcs05RI=" crossorigin="anonymous" ></script> <script> const body = document.body const button = $(".Button") const modal = $(".Modal") const overlay = $(".Overlay") const toggleModal = () => { modal.toggleClass("Modal__isOpen") overlay.toggleClass("Overlay__isOpen") } const toggleScroll = () => { if (isAllowedScroll === true) { fixedScroll() isAllowedScroll = false return } if (isAllowedScroll === false) { releaseScroll() isAllowedScroll = true return } } let isAllowedScroll = true const fixedScroll = () => { document.body.style.top = `-${window.scrollY}px` document.body.style.position = "fixed" } const releaseScroll = () => { const top = document.body.style.top document.body.style.position = "" document.body.style.top = "" window.scrollTo({ top: parseInt(top) * -1, }) } button.on("click", () => { toggleModal() toggleScroll() }) overlay.on("click", () => { toggleModal() toggleScroll() }) </script> </body> </html> |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 |
body { width: 100%; } .Header { width: 100%; height: 60px; background-color: #6ba6e7; display: flex; justify-content: center; align-items: center; } .Logo { color: #fff; font-size: 32px; font-weight: bold; } .Main { width: 100%; padding-top: 12px; padding-left: 32px; padding-right: 32px; padding-bottom: 32px; background-color: #eee; } .Section { margin-top: 20px; width: 100%; height: 400px; background-color: lightgreen; } .Modal { position: fixed; top: 0; bottom: 0; left: 0; right: 0; z-index: 20; margin: auto; width: 400px; height: 200px; padding: 32px; color: #fff; background-color: #6ba6e7; visibility: hidden; opacity: 0; transition: all 0.3s; } .Modal__isOpen { visibility: visible; opacity: 1; } .Overlay { position: fixed; top: 0; left: 0; z-index: 10; width: 100vw; height: 100vh; background-color: rgba(0, 0, 0, 0.2); visibility: hidden; opacity: 0; transition: all 0.3s; } .Overlay__isOpen { visibility: visible; opacity: 1; } .Button { width: 120px; padding: 16px; display: flex; justify-content: center; align-items: center; background-color: #6ba6e7; color: #fff; } |
実装
準備
コードを書き始める前に、ディレクトリ構成の確認とリセットCSSの導入です。
├── index.html
├── resources
└── styles
├── destyle.css
└── style.css
上記の形でファイルを配置しましょう。stylesはルートディレクトリ直下でも良いですが、実際にはresourcesの中にimagesフォルダなどと一緒に入っている形が多いのでそのようにしました。
destyle.cssというのがリセットCSSで、詳細な説明は省きますが各種タグに初期で当たっている様々な余計なスタイルを打ち消してくれるものです。
今回はこちら(https://github.com/nicolas-cusan/destyle.css/blob/master/destyle.css)のものを利用します。こちらのコードをそのままコピーしてdestyle.cssとして上記の場所に配置します。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 |
/*! destyle.css v3.0.0 | MIT License | https://github.com/nicolas-cusan/destyle.css */ /* Reset box-model and set borders */ /* ============================================ */ *, ::before, ::after { box-sizing: border-box; border-style: solid; border-width: 0; } /* Document */ /* ============================================ */ /** * 1. Correct the line height in all browsers. * 2. Prevent adjustments of font size after orientation changes in iOS. * 3. Remove gray overlay on links for iOS. */ html { line-height: 1.15; /* 1 */ -webkit-text-size-adjust: 100%; /* 2 */ -webkit-tap-highlight-color: transparent; /* 3*/ } /* Sections */ /* ============================================ */ /** * Remove the margin in all browsers. */ body { margin: 0; } /** * Render the `main` element consistently in IE. */ main { display: block; } /* Vertical rhythm */ /* ============================================ */ p, table, blockquote, address, pre, iframe, form, figure, dl { margin: 0; } /* Headings */ /* ============================================ */ h1, h2, h3, h4, h5, h6 { font-size: inherit; font-weight: inherit; margin: 0; } /* Lists (enumeration) */ /* ============================================ */ ul, ol { margin: 0; padding: 0; list-style: none; } /* Lists (definition) */ /* ============================================ */ dt { font-weight: bold; } dd { margin-left: 0; } /* Grouping content */ /* ============================================ */ /** * 1. Add the correct box sizing in Firefox. * 2. Show the overflow in Edge and IE. */ hr { box-sizing: content-box; /* 1 */ height: 0; /* 1 */ overflow: visible; /* 2 */ border-top-width: 1px; margin: 0; clear: both; color: inherit; } /** * 1. Correct the inheritance and scaling of font size in all browsers. * 2. Correct the odd `em` font sizing in all browsers. */ pre { font-family: monospace, monospace; /* 1 */ font-size: inherit; /* 2 */ } address { font-style: inherit; } /* Text-level semantics */ /* ============================================ */ /** * Remove the gray background on active links in IE 10. */ a { background-color: transparent; text-decoration: none; color: inherit; } /** * 1. Remove the bottom border in Chrome 57- * 2. Add the correct text decoration in Chrome, Edge, IE, Opera, and Safari. */ abbr[title] { text-decoration: underline dotted; /* 2 */ } /** * Add the correct font weight in Chrome, Edge, and Safari. */ b, strong { font-weight: bolder; } /** * 1. Correct the inheritance and scaling of font size in all browsers. * 2. Correct the odd `em` font sizing in all browsers. */ code, kbd, samp { font-family: monospace, monospace; /* 1 */ font-size: inherit; /* 2 */ } /** * Add the correct font size in all browsers. */ small { font-size: 80%; } /** * Prevent `sub` and `sup` elements from affecting the line height in * all browsers. */ sub, sup { font-size: 75%; line-height: 0; position: relative; vertical-align: baseline; } sub { bottom: -0.25em; } sup { top: -0.5em; } /* Replaced content */ /* ============================================ */ /** * Prevent vertical alignment issues. */ svg, img, embed, object, iframe { vertical-align: bottom; } /* Forms */ /* ============================================ */ /** * Reset form fields to make them styleable. * 1. Make form elements stylable across systems iOS especially. * 2. Inherit text-transform from parent. */ button, input, optgroup, select, textarea { -webkit-appearance: none; /* 1 */ appearance: none; vertical-align: middle; color: inherit; font: inherit; background: transparent; padding: 0; margin: 0; border-radius: 0; text-align: inherit; text-transform: inherit; /* 2 */ } /** * Reset radio and checkbox appearance to preserve their look in iOS. */ [type="checkbox"] { -webkit-appearance: checkbox; appearance: checkbox; } [type="radio"] { -webkit-appearance: radio; appearance: radio; } /** * Correct cursors for clickable elements. */ button, [type="button"], [type="reset"], [type="submit"] { cursor: pointer; } button:disabled, [type="button"]:disabled, [type="reset"]:disabled, [type="submit"]:disabled { cursor: default; } /** * Improve outlines for Firefox and unify style with input elements & buttons. */ :-moz-focusring { outline: auto; } select:disabled { opacity: inherit; } /** * Remove padding */ option { padding: 0; } /** * Reset to invisible */ fieldset { margin: 0; padding: 0; min-width: 0; } legend { padding: 0; } /** * Add the correct vertical alignment in Chrome, Firefox, and Opera. */ progress { vertical-align: baseline; } /** * Remove the default vertical scrollbar in IE 10+. */ textarea { overflow: auto; } /** * Correct the cursor style of increment and decrement buttons in Chrome. */ [type="number"]::-webkit-inner-spin-button, [type="number"]::-webkit-outer-spin-button { height: auto; } /** * 1. Correct the outline style in Safari. */ [type="search"] { outline-offset: -2px; /* 1 */ } /** * Remove the inner padding in Chrome and Safari on macOS. */ [type="search"]::-webkit-search-decoration { -webkit-appearance: none; } /** * 1. Correct the inability to style clickable types in iOS and Safari. * 2. Fix font inheritance. */ ::-webkit-file-upload-button { -webkit-appearance: button; /* 1 */ font: inherit; /* 2 */ } /** * Clickable labels */ label[for] { cursor: pointer; } /* Interactive */ /* ============================================ */ /* * Add the correct display in Edge, IE 10+, and Firefox. */ details { display: block; } /* * Add the correct display in all browsers. */ summary { display: list-item; } /* * Remove outline for editable content. */ [contenteditable]:focus { outline: auto; } /* Tables */ /* ============================================ */ /** 1. Correct table border color inheritance in all Chrome and Safari. */ table { border-color: inherit; /* 1 */ } caption { text-align: left; } td, th { vertical-align: top; padding: 0; } th { text-align: left; font-weight: bold; } |
見た目を作る
ヘッダーとコンテンツ部分
それでは見た目から作りましょう。ヘッダーとコンテンツ部分を用意していきます。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
index.html <!DOCTYPE html> <html lang="ja"> <head> <meta charset="UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Document</title> <link rel="stylesheet" href="./resources/styles/destyle.css" /> <link rel="stylesheet" href="./resources/styles/style.css" /> </head> <body> <header class="Header"> <h1 class="Logo">LOGO</h1> </header> <main class="Main"> <section class="Section"></section> <section class="Section"></section> <section class="Section"></section> <section class="Section"></section> <section class="Section"></section> <section class="Section"></section> <section class="Section"></section> </main> </body> </html> |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 |
style.css .Header { width: 100%; height: 60px; background-color: #6ba6e7; display: flex; justify-content: center; align-items: center; } .Logo { color: #fff; font-size: 32px; font-weight: bold; } .Main { width: 100%; padding-top: 12px; padding-left: 32px; padding-right: 32px; padding-bottom: 32px; background-color: #eee; } .Section { margin-top: 20px; width: 100%; height: 400px; background-color: lightgreen; } |
モーダルウィンドウ部分
続いてモーダルウィンドウとボタンです。
先にモーダルウィンドウから配置して行きます。コンテンツの部分と、背景のグレーの部分です。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
index.html <body> <header class="Header"> ...省略 </header> <!-- ここから --> <div class="Modal">モーダルウィンドウです</div> <div class="Overlay"></div> <!-- ここまで --> <main class="Main"> ...省略 </main> </body> |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
style.css .Modal { position: fixed; top: 0; bottom: 0; left: 0; right: 0; z-index: 20; margin: auto; width: 400px; height: 200px; padding: 32px; color: #fff; background-color: #6ba6e7; } .Overlay { position: fixed; top: 0; left: 0; z-index: 10; width: 100vw; height: 100vh; background-color: rgba(0, 0, 0, 0.2); } |
モーダルウィンドウの中央揃えが少し珍しい方法を使っています。
positionがabsoluteやfixedの時に使える方法で、top/left/right/bottomを全て0にした上でmarginをautoにすると、中央に配置されます。
横方向のみ、縦方向のみに適用させることも可能で、横方向の場合はleft/rightを0にしてmargin-left/margin-rightをautoに、縦方向の場合はtop/bottomを0にしてmargin-top/margin-bottomをautoにすればそれぞれの方向の中央に揃います。
追記:なぜこの方法で中央揃えになるのか、詳しく解説しました。
さて、最初はモーダルウィンドウは非表示でボタンを押した時に表示されます。非表示にするのと、jQueryで付け替える用のクラスの用意を行いましょう。アニメーションの設定もしておきます。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 |
style.css .Modal { ...省略 visibility: hidden; opacity: 0; transition: all 0.3s; } .Modal__isOpen { visibility: visible; opacity: 1; } .Overlay { ...省略 visibility: hidden; opacity: 0; transition: all 0.3s; } .Overlay__isOpen { visibility: visible; opacity: 1; } |
このようにvisibilityとopacityプロパティを用います。visibility: hidden;はdisplay: none;と似たような性質を持ちますがアニメーションを適用できるという違いがあります。
次にボタンを配置します。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 |
index.html <main class="Main"> <section class="Section"> <button class="Button">ボタン</button> </section> <section class="Section"> <button class="Button">ボタン</button> </section> <section class="Section"> <button class="Button">ボタン</button> </section> <section class="Section"> <button class="Button">ボタン</button> </section> <section class="Section"> <button class="Button">ボタン</button> </section> <section class="Section"> <button class="Button">ボタン</button> </section> <section class="Section"> <button class="Button">ボタン</button> </section> </main> |
1 2 3 4 5 6 7 8 9 10 11 12 |
style.css .Button { width: 120px; padding: 16px; display: flex; justify-content: center; align-items: center; background-color: #6ba6e7; color: #fff; } |
これで見た目が出来ました。
動きをつける
さて、いよいよjQueryでクラスの付け替えをしていきます。まずはjQueryを読み込みます。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
index.html <body> <header>...省略</header> <div class="Modal">モーダルウィンドウです</div> <div class="Overlay"></div> <main>...省略</main> //追加 <script src="https://code.jquery.com/jquery-3.6.0.slim.min.js" integrity="sha256-u7e5khyithlIdTpu22PHhENmPcRdFiHRjhAuHcs05RI=" crossorigin="anonymous" ></script> <script> //ここに追加 </script> </body> |
scriptタグはbodyの一番下に書いてください。そして、その次の行からクラス付け替えのコードを実装します。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
index.html <script> const modal = $(".Modal") const overlay = $(".Overlay") const button = $(".Button") const toggleModal = () => { modal.toggleClass("Modal__isOpen") overlay.toggleClass("Overlay__isOpen") } button.on("click", () => { toggleModal() }) overlay.on("click", () => { toggleModal() }) </script> |
モーダルと背景部分に対してクラスを付け替えて行きます。ボタンを押した時と背景部分を押した時に開閉がされるようになります。

背景のスクロールを止める
最後に、モーダルウィンドウが開いているときはスクロールできないようにしていきます。開いている時はスクロールを禁止し、閉じたら再度スクロールができるようになる必要があります。
そこでスクロールをして良いかを判定する変数を用意し、それを使って分岐を行います。fixedScroll関数でスクロールを固定に、releaseScroll関数で固定されたスクロールを解放します。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 |
index.html const toggleModal = () => { ...省略 } let isScrollAllowed = true //追加 //追加 const toggleScroll = () => { if (isScrollAllowed === true) { fixedScroll() //中身はこれから埋めます isScrollAllowed = false return } if (isScrollAllowed === false) { releaseScroll() //中身はこれから埋めます isScrollAllowed = true return } } button.on("click", () => { toggleMenu() toggleScroll() //追加 }) overlay.on("click", () => { toggleMenu() toggleScroll() //追加 }) |
では、スクロールをどう固定するかです。
実はbodyタグにposition: fixedをつけるだけでスクロールができなくなります。メニューを開く時にそれが起こるようにしましょう。
1 2 3 4 5 6 7 8 9 10 |
index.html const toggleScroll = () => { ...省略 } //追加 const fixedScroll = () => { document.body.style.position = "fixed" } |
ただ、これだけではコンテンツエリアのスタイルが崩れてしまうので、cssファイルに以下を追記しておきます。最上部に追記しましょう。
1 2 3 4 5 |
style.css body { width: 100% } |
そして、メニューが閉じるときは今のと逆のことを行います。
1 2 3 4 5 6 7 8 9 10 11 |
index.html const fixedScroll = () => { ...省略 } //追加 const releaseScroll = () => { document.body.style.position = "" } |
これでスクロールの制御ができました。
しかし、これだけでは問題があります。ページを下部にいくらかスクロールした状態でメニューを開くとページ最上部にスクロールが戻ってしまいます。
そこで、すでにスクロールしていた高さ分、bodyを上にずらしましょう。topプロパティに負の値を指定すれば要素は上方向に移動します。
1 2 3 4 5 6 7 8 9 10 11 12 |
index.html const fixedScroll = () => { document.body.style.top = `-${window.scrollY}px` //追加 document.body.style.position = "fixed" } const releaseScroll = () => { document.body.style.position = "" document.body.style.top = "" //戻すのも忘れない } |
こうするとメニューを開いてもスクロール位置は変わりません。しかし、メニューを閉じるときにまたトップに戻ってしまうのでもうひと手間加えます。
1 2 3 4 5 6 7 8 9 10 |
index.html const releaseScroll = () => { const top = document.body.style.top //ずらした高さを保持 document.body.style.position = "" document.body.style.top = "" window.scrollTo({ top: parseInt(top) * -1, }) //保持した高さ分スクロールさせる } |
このように、最初にずらした分だけ再度スクロールをさせてあげることでメニューを閉じた時にスクロール位置が変わらず元のコンテンツを閲覧できます。
ずらした高さはstyleから取得していますが、文字列かつ負の符号が付いています。そこで数値に変換(parseInt関数)してから符号を反転させています。
これでモーダルウィンドウ完成です!
まとめ
ということでモーダルウィンドウの作り方をなるべく細かく解説しました。
他にもいろんなパーツの解説をしていますので、ぜひご覧ください。
コメントを残す