如何通过鼠标滚动或点击退出全屏模式（Fullscreen API 实战教程）-html教程-PHP中文网

本文详解如何使用原生 javascript 结合 fullscreen api，实现点击触发全屏、滚动鼠标自动退出全屏，并妥善管理事件监听器生命周期，避免内存泄漏与重复绑定。

本文详解如何使用原生 javascript 结合 fullscreen api，实现点击触发全屏、滚动鼠标自动退出全屏，并妥善管理事件监听器生命周期，避免内存泄漏与重复绑定。

在现代网页开发中，Fullscreen API 是提升沉浸式体验（如图片画廊、视频播放器、数据看板）的常用手段。但默认情况下，浏览器仅支持按 ESC 键或调用 document.exitFullscreen() 退出全屏——而用户期望更自然的交互，例如向上/向下滚动即退出，或点击任意区域退出。本文将手把手带你构建一个健壮、可维护的解决方案。

✅ 核心思路

使用 requestFullscreen() 进入全屏，exitFullscreen() 退出；
监听全局 fullscreenchange 事件，实时感知全屏状态变化；
仅在全屏激活时，为指定容器（如 .element）绑定 scroll 事件，滚动即触发退出；
点击切换按钮时，动态增删 scroll 监听器，确保事件精准可控；
避免使用 addEventListener('scroll', handler, { once: true }) 的陷阱：once: true 不适用于需反复启用/禁用的场景。

? 完整可运行代码示例



  <style>
    .element {
      height: 100vh;
      overflow-y: auto;
      padding: 2rem;
      background: #f5f5f5;
    }
    .toggle {
      display: inline-block;
      padding: 0.5rem 1rem;
      background: #007bff;
      color: white;
      text-decoration: none;
      border-radius: 4px;
      margin-bottom: 1rem;
    }
  </style><a href="#" class="toggle">? 切换全屏</a>
  <div class="element">
    <h2>图片画廊预览区</h2>
    <p>滚动我试试 → 全屏状态下，滚动将自动退出全屏。</p>
    <p style="height: 200vh; background: linear-gradient(to bottom, #eee, #ccc);"></p>
  </div>

  <script>
    const toggleFullScreen = () => {
      if (!document.fullscreenElement) {
        document.documentElement.requestFullscreen()
          .catch(e => console.warn("全屏请求被拒绝：", e));
        return true;
      } else {
        document.exitFullscreen();
        return false;
      }
    };

    const handleScroll = () => {
      if (document.fullscreenElement) {
        document.exitFullscreen();
      }
    };

    const toggleLink = document.querySelector('.toggle');
    const el = document.querySelector('.element');

    // 全屏状态变更时清理 scroll 监听器（关键！）
    document.addEventListener('fullscreenchange', () => {
      if (!document.fullscreenElement) {
        el.removeEventListener('scroll', handleScroll);
      }
    });

    // 绑定点击切换逻辑
    toggleLink.addEventListener('click', e => {
      e.preventDefault();
      const isNowFullscreen = toggleFullScreen();

      if (isNowFullscreen) {
        // 进入全屏后，才监听滚动（防误触 & 资源节约）
        el.addEventListener('scroll', handleScroll);
      }
    });
  </script>

⚠️ 注意事项与最佳实践

权限与兼容性：requestFullscreen() 在部分浏览器（如 Safari iOS）中需用户手势触发（如 click），不可在 setTimeout 或 load 中静默调用；务必包裹 .catch() 处理拒绝异常。
事件委托慎用：不要对 window 或 document 绑定 scroll —— 全屏时页面可能无滚动条，且易导致误触发；应绑定到实际可滚动的容器（如 .element）。
监听器清理是必须项：每次退出全屏后，必须显式调用 removeEventListener。若遗漏，多次进入/退出会导致 scroll 事件被重复绑定，引发性能下降甚至崩溃。
移动端适配：触摸滚动（touchmove）未在本例覆盖；如需支持，可扩展监听 touchmove 并节流处理（防止高频触发）。