HTML / CSS / 系统课时

构建弹窗叠加布局

构建弹窗叠加布局

标准弹窗不是简单地把一个盒子放到页面中央,而是同时处理全屏定位、遮罩、层级、滚动和键盘交互。本课将拆分弹窗的空间结构,并完成一个可打开、关闭、按 Escape 退出且能恢复焦点的模态框。

学习目标

  • 使用 fixed、inset-0 和 z-* 建立稳定的叠加层。
  • 组合遮罩、居中容器与弹窗面板,避免滚动和裁切问题。
  • 为弹窗补充关闭、Escape、焦点恢复与基础无障碍属性。

拆分弹窗的四层结构

一个可靠的弹窗可拆成页面内容、全屏叠加容器、半透明遮罩和前景面板。叠加容器使用 fixed inset-0 z-50 覆盖视口;遮罩使用 absolute inset-0 铺满容器;面板使用 relative z-10 位于遮罩上方。

关闭按钮通常相对面板绝对定位,因此面板本身需要 relative。把全部弹窗内容放进同一个顶层叠加容器,可以让层级关系集中管理,避免遮罩和面板分散在不同堆叠上下文中。

模态框叠加层与定位关系

组合定位、居中与滚动

外层可使用 flex min-h-full items-center justify-center p-4 让面板在视口中居中,并保留小屏边距。面板使用 w-full max-w-lg 控制宽度,再通过 max-h-[calc(100vh-2rem)] overflow-y-auto 限制高度,让长内容在面板内部滚动。

遮罩适合使用 bg-slate-950/60,它只改变背景颜色透明度,不会让面板一起变淡。不要把 opacity-60 加在整个叠加容器上,否则弹窗文字、按钮和边框也会同时透明。

完整示例与预期结果

下面的单文件示例包含打开按钮、遮罩点击关闭、Escape 关闭、页面滚动锁定和焦点恢复。保存为 index.html 后在浏览器打开即可验证。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Tailwind 模态框</title>
  <script src="https://cdn.tailwindcss.com"></script>
</head>
<body class="min-h-screen bg-slate-100 p-8">
  <button
    id="openModal"
    class="rounded-lg bg-blue-600 px-4 py-2 font-medium text-white hover:bg-blue-700"
  >
    打开弹窗
  </button>

  <div id="modal" class="fixed inset-0 z-50 hidden" aria-hidden="true">
    <div class="absolute inset-0 bg-slate-950/60" data-backdrop></div>

    <div class="relative z-10 flex min-h-full items-center justify-center p-4">
      <section
        class="relative max-h-[calc(100vh-2rem)] w-full max-w-lg overflow-y-auto rounded-2xl bg-white p-6 shadow-2xl"
        role="dialog"
        aria-modal="true"
        aria-labelledby="modalTitle"
      >
        <button
          id="closeModal"
          class="absolute right-4 top-4 rounded-md px-2 py-1 text-slate-500 hover:bg-slate-100"
          aria-label="关闭弹窗"
        >
          ×
        </button>

        <h1 id="modalTitle" class="pr-10 text-xl font-semibold text-slate-900">
          确认发布内容
        </h1>
        <p class="mt-3 text-slate-600">
          发布后内容将对所有成员可见,请确认标题、正文和附件均已检查。
        </p>
        <div class="mt-6 flex justify-end gap-3">
          <button id="cancelModal" class="rounded-lg border px-4 py-2">
            取消
          </button>
          <button class="rounded-lg bg-blue-600 px-4 py-2 text-white">
            确认发布
          </button>
        </div>
      </section>
    </div>
  </div>

  <script>
    const modal = document.querySelector("#modal");
    const openButton = document.querySelector("#openModal");
    const closeButton = document.querySelector("#closeModal");
    const cancelButton = document.querySelector("#cancelModal");

    function openModal() {
      modal.classList.remove("hidden");
      modal.setAttribute("aria-hidden", "false");
      document.body.classList.add("overflow-hidden");
      closeButton.focus();
    }

    function closeModal() {
      modal.classList.add("hidden");
      modal.setAttribute("aria-hidden", "true");
      document.body.classList.remove("overflow-hidden");
      openButton.focus();
    }

    openButton.addEventListener("click", openModal);
    closeButton.addEventListener("click", closeModal);
    cancelButton.addEventListener("click", closeModal);

    modal.addEventListener("click", (event) => {
      if (event.target.matches("[data-backdrop]")) closeModal();
    });

    document.addEventListener("keydown", (event) => {
      if (event.key === "Escape" && !modal.classList.contains("hidden")) {
        closeModal();
      }
    });
  </script>
</body>
</html>

预期结果

text
点击“打开弹窗”后,页面出现全屏深色遮罩和居中的白色面板,背景页面停止滚动。点击遮罩、关闭按钮、取消按钮或按 Escape 都会关闭弹窗,并把焦点返回“打开弹窗”按钮。

验收要点与常见失败

先缩小浏览器宽度,确认面板两侧始终保留间距;再增加弹窗内容,确认面板不超过视口且内部可以滚动。最后使用键盘验证打开后焦点进入弹窗,关闭后焦点返回触发按钮。

若 z-50 仍被其他区域盖住,通常不是数值太小,而是弹窗位于带有 transform、filter 或独立层级的祖先内部。更稳妥的做法是把弹窗节点放在页面根部。生产项目还应使用成熟组件补充完整焦点陷阱,防止 Tab 键跳到背景内容。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

构建弹窗叠加布局

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通