怎么用JavaScript监听滚动或窗口变化动态调整CSS样式

作者:微光

时间:2026-11-18

浏览:585

深入讲解如何使用JavaScript监听浏览器的scroll与resize事件,利用classList与CSS自定义属性动态调整页面样式,并结合requestAnimationFrame和passive选项解决高频性能瓶颈。

文章目录
怎么用JavaScript监听滚动或窗口变化动态调整CSS样式
图 0:JavaScript 监听事件驱动 CSS 样式动态调整机制概览
动态调整样式的核心逻辑在于通过 window.addEventListener 捕获 scroll(页面滚动)或 resize(窗口缩放)事件,在回调函数中计算目标几何数据(如滚动位移或视口宽高),进而驱动样式变化。在实际工程中,最稳健的做法并不是在 JavaScript 中直接硬编码元素的 CSS 属性,而是结合预设 CSS 类名(classList)或 CSS 自定义属性(CSS 变量),并搭配 requestAnimationFrame 组织帧级渲染,以避免引起页面卡顿或重排。

一、核心度量:如何准确获取滚动位移与窗口尺寸

在调整任何样式之前,必须首先从浏览器环境中读取准确的几何尺寸。处理滚动与窗口调整涉及两组不同的全局属性。

1. 滚动位置的获取

页面滚动时,最常用的是垂直滚动位移 window.scrollY。该属性返回文档在垂直方向滚动的像素数。在一些旧版本渲染模式或某些特制容器中,可以通过 document.documentElement.scrollTop 进行降级兼容:

// 获取当前页面的垂直滚动像素
const currentScrollY = window.scrollY || document.documentElement.scrollTop;

如果页面总高度为 document.documentElement.scrollHeight,当前视口高度为 window.innerHeight,则页面可滚动的最大距离为两者之差。此时可换算出精确的滚动百分比(0 到 1 之间)。

2. 视口尺寸的获取

当浏览器窗口发生缩放或设备方向旋转时,通过 window.innerWidth 和 window.innerHeight 可以直接获取当前可视区域的宽度与高度(包括滚动条所占的像素):

// 获取当前视口的有效宽高
const viewportWidth = window.innerWidth;
const viewportHeight = window.innerHeight;
怎么用JavaScript监听滚动或窗口变化动态调整CSS样式
图 1:浏览器文档、可视窗口与滚动偏移量几何度量模型

二、方案对比:修改内联样式 vs 切换类名 vs 注入 CSS 变量

获取到数值后,如何将其反馈到 DOM 节点上?在实际开发中通常有三种途径,在不同需求场景下选择合适的方案对于代码质量与运行时性能有决定性影响。

比较维度 方式 1:直接内联修改 (style.prop) 方式 2:预设类名切换 (classList) 方式 3:注入 CSS 变量 (setProperty)
状态类型 连续坐标 / 任意即时计算值 离散状态(开 / 关 / 激活) 连续数值(进度、缩放系数)
职责解耦 弱,CSS 样式硬编码在 JS 中 极强,JS 仅管状态,样式由 CSS 管理 优良,JS 注入数值,CSS 统一消费
重排重绘开销 高(若频繁改动宽高/内边距) 低(配合 transition 与 transform) 低(单点写入,局部重绘)
动画过渡支持 需在 JS 中手动计算补间或额外设 transition 天然契合 CSS transition,自动平滑补间 可在 CSS 中与 calc() 联动

为什么直接操作内联样式与切换类名存在关键差异?

理解这种差异为什么重要,是写出流畅交互的关键:

  • 关注点分离与代码维护:直接通过 element.style.backgroundColor = '#fff' 设置样式,会让视觉细节分散在业务逻辑中。一旦 UI 改版,需要去翻找 JavaScript 代码;而通过 element.classList.toggle('is-scrolled', scrollY > 80),JavaScript 只负责回答“页面是否滚过了 80px”这个布尔事实,具体的阴影、透明度、背景模糊等样式细节完全留在 CSS 文件内。
  • 渲染性能与硬件加速:当在滚动回调中高频执行 element.style.height = '60px' 时,直接修改几何尺寸会强制浏览器在主线程重新计算布局(Reflow),引发页面掉帧;而预先在 CSS 中定义好 .is-scrolled 类,并通过 transform: translateY(0) 和 opacity 进行修饰,浏览器能将绘制任务分派给 GPU 合成线程(Compositor),保证 60fps 乃至 120fps 的流畅体验。
怎么用JavaScript监听滚动或窗口变化动态调整CSS样式
图 2:三种动态样式调整方案的设计取舍与性能表现对比

三、实战步骤:实现自适应吸顶导航栏与滚动进度指示

下面通过一个具体可运行的案例,演示如何完整实现“页面向下滚动超过 80 像素时导航栏变色并吸顶,同时顶部展示细红条阅读进度,且在窗口宽度小于 768px 时自动适配移动端布局”。

怎么用JavaScript监听滚动或窗口变化动态调整CSS样式
图 3:JavaScript 监听事件到样式生效的标准执行链路

步骤 1:编写 HTML 骨架与基准 CSS

在页面中放置进度条容器与导航条,并在 CSS 中预先配置好基础状态与 .nav--scrolled 状态:

<!-- 顶部细线滚动进度条 -->
<div id="progressBar" class="progress-bar"></div>

<!-- 自适应导航栏 -->
<nav id="mainNav" class="nav">
  <div class="nav-container">
    <span class="nav-logo">SiteLogo</span>
    <span class="nav-status" id="navStatus">桌面视图</span>
  </div>
</nav>

对应 CSS 样式:

/* 基础变量定义 */
:root {
  --scroll-progress: 0%;
}

/* 顶部进度条:基于 CSS 变量动态更新宽度 */
.progress-bar {
  position: fixed;
  top: 0;
  left: 0;
  height: 3px;
  width: var(--scroll-progress);
  background-color: #879B88;
  z-index: 1001;
  transition: width 0.05s linear;
}

/* 默认状态导航栏 */
.nav {
  position: fixed;
  top: 0;
  left: 0;
  width: 100%;
  height: 64px;
  background-color: transparent;
  color: #333333;
  z-index: 1000;
  transition: background-color 0.3s ease, box-shadow 0.3s ease, height 0.3s ease;
}

/* 滚动吸顶后的状态:紧凑高度、白色背景与阴影 */
.nav.nav--scrolled {
  background-color: rgba(255, 255, 255, 0.95);
  backdrop-filter: blur(8px);
  box-shadow: 0 2px 12px rgba(0, 0, 0, 0.08);
  height: 52px;
}

/* 移动端窄屏模式 */
.nav.nav--compact {
  padding: 0 12px;
}

步骤 2:注册带有 passive 标志的监听器并结合 rAF 调度

由于滚动和视口变动事件触发极为频繁,直接在事件处理函数里频繁读写 DOM 会严重影响性能。标准工程实践是利用 requestAnimationFrame 确保计算与浏览器的单帧绘制周期严格对齐:

// 获取目标节点
const nav = document.getElementById('mainNav');
const navStatus = document.getElementById('navStatus');
const rootElement = document.documentElement;

// 调度标记:防止单帧内多次重复排队
let isTicking = false;

function updateStyles() {
  // 1. 读取几何数据
  const scrollY = window.scrollY || rootElement.scrollTop;
  const viewportWidth = window.innerWidth;
  const totalDocHeight = rootElement.scrollHeight - window.innerHeight;

  // 2. 动态调整吸顶导航状态(通过 classList)
  const shouldBeScrolled = scrollY > 80;
  nav.classList.toggle('nav--scrolled', shouldBeScrolled);

  // 3. 动态响应窗口宽度(判定断点 768px)
  const isMobile = viewportWidth < 768;
  nav.classList.toggle('nav--compact', isMobile);
  if (navStatus) {
    navStatus.textContent = isMobile ? '移动端布局' : '桌面端布局';
  }

  // 4. 动态更新滚动进度条(通过 CSS 变量)
  if (totalDocHeight > 0) {
    const progressPercent = Math.min(100, Math.max(0, (scrollY / totalDocHeight) * 100));
    rootElement.style.setProperty('--scroll-progress', `${progressPercent}%`);
  }

  // 释放执行锁,允许下一次调度
  isTicking = false;
}

// 事件处理包装:帧级限频
function onViewportChange() {
  if (!isTicking) {
    window.requestAnimationFrame(updateStyles);
    isTicking = true;
  }
}

// 注册监听器,声明 passive: true 保证滚动无阻塞
window.addEventListener('scroll', onViewportChange, { passive: true });
window.addEventListener('resize', onViewportChange, { passive: true });

// 初始化执行一次,保证首屏渲染状态准确
updateStyles();

步骤 3:结果验证

在页面中加载上述代码后,通过以下操作验证效果:

  1. 向下滑动页面超过 80 像素,导航栏背景平滑淡入半透明磨砂白,高度微缩为 52px,阴影显现;回滚至顶部后自动恢复透明。
  2. 持续向下浏览文章,最顶部进度条平滑拉长,滑至底部时精准停留在 100%。
  3. 拖拽浏览器窗口边缘使宽度小于 768 像素,文字提示即时更新为“移动端布局”,同时容器自动收窄内边距。

四、性能瓶颈与高频调度优化机制

滚动(scroll)和窗口尺寸变动(resize)是浏览器中最常见的高频事件。在普通的 60Hz 屏幕上,每秒只有大约 16.6 毫秒来完成一帧内所有的 JavaScript 计算、样式重算、布局和绘制。如果屏幕刷新率是 90Hz 或 120Hz,单帧可用时间甚至不足 8 毫秒。

怎么用JavaScript监听滚动或窗口变化动态调整CSS样式
图 4:高频监听性能机制与架构总结

1. 为什么必须使用 { passive: true }?

在默认情况下,浏览器在触发 scroll 或 touchmove 事件时,并不知道你的回调函数里会不会调用 event.preventDefault() 取消滚动。为了确保语义准确,浏览器不得不暂停滚动线程,等待 JavaScript 执行完毕再继续滚动。

通过在第三个参数中传递 { passive: true },相当于向浏览器引擎做出承诺:“我绝对不会调用 preventDefault()”。浏览器便可以立即在后台平滑滚动页面,无需同步等待脚本回调,从底层根除了手势迟滞问题。

2. 避免强制同步布局(Layout Thrashing)

当你在一个函数里先读取几何属性(如 element.offsetTop、window.scrollY),紧接着又修改样式属性(如 element.style.top = ...),如果在一个循环或短时间内反复交替读写,浏览器为了向你返回最新的准确位置,必须立即强制刷新渲染树并重新计算几何分布。

优化原则: 将“读取(Read)”操作全部集中放在函数前半部分完成;将“写入(Write)”操作(如 classList.add 或 setProperty)集中在后半部分统一提交。

3. 现代替代方案:IntersectionObserver 与 ResizeObserver

如果你的需求只是“当某个组件进入视口时添加动画”或者“监听某个特定 div 容器自身的宽高变化”,直接监听全局的 window.scroll 和 window.resize 并非最优解。浏览器提供了更轻量、异步的现代化 API:

  • IntersectionObserver:专门用于检测目标元素与视口的交叉状态。它在浏览器内部由合成器异步处理,无需开发者手动计算 scrollY 与元素的 getBoundingClientRect(),极度省电且不会造成主线程堵塞。
  • ResizeObserver:用于监听单个 DOM 容器的尺寸变化(例如侧边栏收起导致主内容区宽度改变)。相较于 window.onresize 只能感知全局窗口尺寸,ResizeObserver 颗粒度更准,能完美处理容器自身的微小布局变形。

五、常见边界问题与注意事项

在实际落地与跨端兼容过程中,还需注意以下细节:

1. 移动端浏览器动态工具栏对 100vh 的影响

在移动端 Safari 或 Chrome 中滚动页面时,底部导航条和顶部地址栏会自动收缩或展开,导致 window.innerHeight 发生动态跳动。如果在 resize 回调中强行重算高度,会产生页面晃动。推荐在现代 CSS 中优先使用 100dvh(动态视口高度)或者 100svh(小视口高度),仅在不支持时才通过 JavaScript 读取视口高度并设置 CSS 变量 --vh。

2. 避免在连续计算属性上同时开启 CSS transition

如果你通过 JavaScript 高频更新一个数值(例如根据滚动位置每帧设置进度条的 width 或指示器的位移),请确保在 CSS 中不要对该属性施加耗时较长的 transition(例如 transition: width 0.3s)。如果 JavaScript 每 16ms 赋一个新值,而 CSS 还在执行 300ms 的过渡,动画会产生严重的拖滞感或抖动。对于高频连续计算的值,应将 transition 设为 none 或极小的补间时间。

3. 组件销毁时及时移除事件监听器

在 Vue、React 或原生单页应用(SPA)开发中,若在页面或组件挂载时注册了全局监听,在组件卸载或路由切换时,必须使用相同命名的函数引用调用 window.removeEventListener,避免闭包引用的 DOM 无法被垃圾回收导致严重的内存泄漏:

// 挂载时
window.addEventListener('scroll', onViewportChange, { passive: true });

// 销毁时清理
window.removeEventListener('scroll', onViewportChange);

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章