推荐使用 VueUse 的 useWindowSize 组合式函数,一行代码获取响应式宽高,自动绑定 resize 事件并卸载时清理,支持 inner/outer/visual 模式;自定义 useScreen 可结合防抖与 computed 实现断点判断,确保客户端执行且兼容 SSR。

Vue 3 组合式函数处理窗口大小变化,核心是把 window.innerWidth 和 window.innerHeight 封装成响应式状态,并自动管理事件监听与清理。推荐使用封装成熟、性能可控的方案,而不是手动写 addEventListener。
用 useWindowSize(最简可靠)
VueUse 的 useWindowSize 是专为此场景设计的组合式函数,一行代码即可获得响应式宽高:
- 返回
width和height两个ShallowRef,天然轻量,避免对原始数值做多余代理 - 内部自动绑定
resize事件,并在组件卸载时调用removeEventListener,无需手动清理 - 支持
inner(默认)、outer、visual三种尺寸模式,适配不同需求(如 PWA 的视觉视口)
示例:
<script setup lang="ts"><br> import { useWindowSize } from '@<a style="color:#f60; text-decoration:underline;" title= "vue"href="https://m.php.cn/zt/15721.html" target="_blank">vueuse/core'<br> const { width, height } = useWindowSize()<br></script>自定义 useScreen(带断点判断)
如果需要更语义化的响应式状态(如 isMobile、breakpoint),可封装 useScreen Hook:
- 基于
useWindowSize或原生resize事件,配合防抖(50–100ms)防止高频触发 - 用
computed动态计算设备类型和断点,例如:isMobile: computed(() => width.value - 确保只在客户端执行(
typeof window !== 'undefined'),兼容 SSR 场景
配合组件逻辑做响应式行为
拿到响应式尺寸后,重点是如何驱动真实交互:
- 模板中直接用
v-if="width 控制移动端菜单显隐 - 在
watch中监听width变化,触发布局重排或图表resize() - 与 ECharts、xterm.js 等库联动时,在
onMounted注册 resize 回调,onUnmounted清理,避免内存泄漏
不建议手动监听 resize
虽然可以直接用 window.addEventListener('resize', ...),但容易遗漏细节:
- 忘记在
onBeforeUnmount或onUnmounted移除监听,造成内存泄漏 - 未做防抖,窗口拖拽时频繁触发影响性能
- SSR 环境下访问
window报错,需额外守卫 - 无法复用,每个组件重复写相同逻辑
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










