Vue Composition API 处理窗口大小变化的核心是挂载时注册 resize 监听器、响应式更新尺寸、卸载时自动清理;推荐优先使用 VueUse 的 useWindowSize(返回 ShallowRef,支持多尺寸模式,自动生命周期管理),也可手动封装轻量版并注意节流与清理。

Vue Composition API 处理窗口大小变化,核心思路是:在组件挂载时注册 resize 事件监听器,响应式地更新尺寸值,并在组件卸载时自动清理,避免内存泄漏。推荐优先使用封装好的组合式函数(如 useWindowSize),也可手动实现以满足轻量或定制需求。
直接用 useWindowSize(最简方案)
来自 VueUse 的 useWindowSize 是专为 Composition API 设计的开箱即用方案,内部已处理响应式绑定、事件监听与自动清理:
- 返回
width和height两个ShallowRef,性能更优(不包装原始 number) - 默认监听
window.innerWidth / innerHeight,支持inner、outer、visual三种尺寸模式 - 无需手动
onMounted或onUnmounted—— 它自动完成生命周期绑定
示例:
<script setup><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>
手动实现(理解原理)
若暂不引入第三方库,可基于 Composition API 手动封装一个轻量版:
- 用
ref创建响应式宽高变量 - 在
onMounted中添加resize监听器,更新 ref 值 - 在
onUnmounted中移除监听器(关键!否则易造成内存泄漏) - 可加节流(
useThrottleFn)防高频触发,尤其在拖拽调整窗口时
代码片段:
import { ref, onMounted, onUnmounted } from 'vue'
export function useWindowResize() {
const width = ref(window.innerWidth)
const height = ref(window.innerHeight)
const updateSize = () => {
width.value = window.innerWidth
height.value = window.innerHeight
}
onMounted(() => window.addEventListener('resize', updateSize))
onUnmounted(() => window.removeEventListener('resize', updateSize))
return { width, height }
}
配合 watch 或计算属性做响应式逻辑
拿到响应式尺寸后,常见后续操作包括:
- 用
watch监听宽高变化,执行布局切换(如移动端菜单收起/展开) - 用
computed派生状态,比如isMobile: computed(() => width.value - 结合
onBeforeUnmount清理副作用(如图表 resize 回调)
注意:不要在 watch 中直接读取 window.innerWidth —— 应始终基于响应式变量(如 width)监听,保证响应链完整。
进阶提示:避免常见坑
实际开发中容易忽略的细节:
-
首次渲染时机:
window.innerWidth在 SSR 环境下不可用,需加if (typeof window !== 'undefined')判断 -
方向变更(移动端):iOS Safari 的横竖屏切换可能不触发
resize,建议补充监听orientationchange -
iframe 场景:若应用嵌入 iframe,需监听
iframe.contentWindow而非顶层window -
视觉视口(visual viewport):缩放页面时,
innerWidth不变但用户可见区域变化,此时应改用visualViewport.width/height并监听其resize事件
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










