萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 實現簡易彈出層(Modal)組件完整教學

前言

彈出層是 Web 應用中最常見的 UI 組件之一。本文基於 jQuery,從零構建一個具備遮罩層、進場/離場動畫、表單載入、拖拽關閉等功能的彈出層組件,並解析核心邏輯與擴展要點。

組件架構拆解

彈出層主要由三部分組成:

  1. 觸發器:點擊按鈕/連結開啟彈窗。
  2. 遮罩層:.body-color,半透明黑背景,點擊可關閉(可選)。
  3. 彈窗主體:.hide-body,包含標題欄(關閉鈕)、內容區(表單/自定義內容)、底部區。

完整代碼實現

HTML 結構

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>jQuery 彈出層演示</title>
  <style>
    /* 基礎重置 */
    * { box-sizing: border-box; margin: 0; padding: 0; }
    body { font-family: "Microsoft JhengHei", sans-serif; padding: 20px; }

    /* 觸發按鈕 */
    .btn { display: inline-block; padding: 8px 16px; background: #007bff; color: #fff; border: none; border-radius: 4px; cursor: pointer; }
    .btn:hover { background: #0056b3; }

    /* 遮罩層 */
    .body-color {
      display: none;
      position: fixed; top: 0; left: 0; width: 100%; height: 100%;
      background: rgba(0,0,0,0.5); z-index: 1000;
    }

    /* 彈窗主體 */
    .hide-body {
      display: none;
      position: fixed; top: 50%; left: 50%; transform: translate(-50%, -50%);
      width: 400px; background: #fff; border-radius: 6px; box-shadow: 0 4px 20px rgba(0,0,0,0.2);
      z-index: 1001; overflow: hidden;
    }
    .close-window {
      position: relative; padding: 15px 20px; border-bottom: 1px solid #eee; background: #f9f9f9;
    }
    .close-window .close {
      position: absolute; top: 10px; right: 15px; font-size: 24px; color: #999; text-decoration: none; cursor: pointer;
    }
    .close-window .close:hover { color: #333; }
    .close-window h3 { margin: 0; font-size: 16px; color: #333; }

    .login-body { padding: 20px; }
    .signin ol { list-style: none; }
    .signin li { margin-bottom: 15px; }
    .signin label { display: block; margin-bottom: 5px; font-weight: bold; color: #555; }
    .signin .ipt { width: 100%; padding: 8px 12px; border: 1px solid #ddd; border-radius: 4px; font-size: 14px; }
    .signin .btn-primary { width: 100%; padding: 10px; background: #28a745; color: #fff; border: none; border-radius: 4px; font-size: 16px; cursor: pointer; }
    .signin .btn-primary:hover { background: #218838; }

    .bottom { padding: 15px 20px; border-top: 1px solid #eee; font-size: 12px; color: #999; text-align: center; }
  </style>
</head>
<body>
  <button class="btn login">點擊開啟登入彈窗</button>

  <!-- 遮罩層 -->
  <div class="body-color"></div>

  <!-- 彈窗主體 -->
  <div class="hide-body">
    <div class="close-window">
      <a href="javascript:;" class="close" title="關閉">×</a>
      <h3>會員登入</h3>
    </div>
    <div class="login-body dform">
      <form class="signin" name="loginform" method="post" action="#">
        <ol>
          <li><label for="username">帳號:</label><input class="ipt" type="text" id="username" placeholder="請輸入帳號" /></li>
          <li><label for="password">密碼:</label><input class="ipt" type="password" id="password" placeholder="請輸入密碼" /></li>
          <li><input class="btn btn-primary" type="submit" value="登 入" /></li>
        </ol>
      </form>
    </div>
    <div class="bottom"><p>忘記密碼? <a href="#">點此重設</a></p></div>
  </div>

  <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
  <script>
    $(function() {
      var $mask = $('.body-color');
      var $dialog = $('.hide-body');

      // 開啟彈窗
      $('.login').on('click', function() {
        $mask.fadeIn(200);
        $dialog.slideDown(300); // 或使用 fadeIn + CSS 動畫
      });

      // 關閉彈窗(關閉鈕、遮罩點擊、ESC 鍵)
      function closeDialog() {
        $mask.fadeOut(200);
        $dialog.slideUp(200);
      }

      $('.close-window .close').on('click', closeDialog);
      $mask.on('click', closeDialog); // 點擊遮罩關閉

      $(document).on('keydown', function(e) {
        if (e.key === 'Escape' && $dialog.is(':visible')) closeDialog();
      });

      // 表單提交示例(防止預設跳轉)
      $('.signin').on('submit', function(e) {
        e.preventDefault();
        var user = $('#username').val();
        var pass = $('#password').val();
        alert('提交:' + user + ' / ' + pass);
        closeDialog();
      });
    });
  </script>
</body>
</html>

核心邏輯解析

1. 狀態管理

使用兩個 jQuery 物件 $mask、$dialog 分別控制遮罩與彈窗的顯示/隱藏,透過 fadeIn/fadeOut、slideDown/slideUp 實現漸變與滑動動畫。

2. 事件綁定最佳實踐

  • 使用 .on('click', handler) 而非舊版 .click(),支援動態元素與命名空間。
  • 關閉邏輯封裝為 closeDialog(),避免重複代碼,便於 ESC 鍵、遮罩點擊、關閉鈕複用。
  • 表單提交攔截 e.preventDefault(),配合 AJAX 送出,提升體驗。

3. 定位與層級

  • 遮罩 position: fixed; top:0; left:0; width:100%; height:100%; z-index:1000 覆蓋全頁。
  • 彈窗 position: fixed; top:50%; left:50%; transform:translate(-50%, -50%) 實現垂直水平置中,z-index:1001 置於遮罩之上。

進階擴展建議

  1. 拖拽移動:在 .close-window 綁定 mousedown 記錄初始座標,mousemove 計算位移更新 top/left(需移除 transform 定位)。
  2. 響應式寬度:設定 max-width: 90vw; width: 500px; 適配行動裝置。
  3. 無障礙(a11y):添加 role="dialog"、aria-modal="true"、aria-labelledby="dialog-title",開啟時焦點移入彈窗首個可聚焦元素,關閉時焦點回歸觸發器。
  4. 多實例管理:封裝為 jQuery Plugin 或 ES6 Class,支援多彈窗堆疊(z-index 遞增)、內容動態載入(AJAX/iframe)。
  5. 動畫優化:改用 CSS transition + class 切換,啟用 GPU 加速,避免 JS 動畫導致掉幀。

總結

本文實現了一個結構清晰、交互完整的 jQuery 彈出層組件。核心在於「遮罩+彈窗」的雙層結構、統一的關閉入口、以及固定定位置中技巧。在現代專案中,建議直接採用成熟庫(Bootstrap Modal, Element Plus Dialog, Ant Design Modal 等),但理解原生實現邏輯有助於客製化需求與故障排查。

copyright © 萬盛學電腦網 all rights reserved