window.innerWidth和window.innerHeight是JavaScript中用于获取浏览器视口(viewport)宽度和高度的属性。它们返回的是浏览器窗口的可见区域尺寸,不包括浏览器工具栏、地址栏等非可视部分。1. 获取视口宽度和高度const width = window.innerWidth; const height = window.innerHeight; cons
时间:2026-05-19 21:24:37 173浏览 收藏
window.innerWidth 和 window.innerHeight 是前端开发中获取浏览器可视区域尺寸的核心API,它们以CSS像素为单位精确反映用户当前可见的视口宽高(已扣除滚动条占用空间,但受缩放影响),广泛应用于响应式布局、动态适配和交互优化;然而其行为在移动端(如Safari地址栏展开/旋转)、iframe上下文、SSR环境及旧版IE中存在诸多陷阱,需配合resize事件监听、节流处理、环境判断和与clientWidth/clientHeight的合理选用来确保稳定可靠——掌握这些细节,才能真正让“所见即所得”的响应式体验落地无误。

直接读取 window.innerWidth 和 window.innerHeight 就行,但要注意它们返回的是 CSS 像素,不是设备物理像素
这两个属性在绝大多数现代浏览器中都可用,返回当前视口(即用户可见区域)的宽高,单位是 CSS 像素。比如在桌面浏览器缩放为 125% 时,window.innerWidth 会比实际屏幕宽度小,因为它反映的是“渲染后可见多少个 CSS 像素”,而不是设备像素数。
常见错误现象:
– 在 iOS Safari 横屏旋转后首次读取,值没更新(需监听 resize)
– 误以为它包含滚动条宽度(实际上已扣除垂直滚动条宽度)
– 在 iframe 中调用却忘了上下文:它始终返回**调用者所在窗口**的视口尺寸,不是父页面的
- 不要在页面加载前就取值(如 script 标签放在
且没加defer),DOM 可能未就绪,但window对象已存在,所以通常安全;不过若依赖布局(比如配合getBoundingClientRect),建议等DOMContentLoaded - 移动端注意:Safari 地址栏收起/展开会触发
resize,innerHeight会变化,不能假设它固定 - 不支持 IE8 及更早版本;IE9+ 支持,但 IE9 在怪异模式下可能返回
document.body.clientWidth类似行为,建议强制标准模式
监听视口变化必须用 resize 事件,但别直接绑 window.onresize
resize 触发非常频繁(尤其拖拽窗口时),直接执行重绘逻辑容易卡顿。原生 window.onresize = handler 会被覆盖,也不利于解绑。
- 用
window.addEventListener('resize', handler),便于多次绑定和单独移除 - 务必节流(throttle):哪怕只是简单更新一个
const viewport = { w: window.innerWidth, h: window.innerHeight },也建议用setTimeout或requestAnimationFrame包一层,避免每毫秒都计算 - 在单页应用(SPA)中,路由切换可能不触发
resize,但视口实际没变——这时候不需要重新获取,别为了“保险”而重复读取
innerWidth/Height 和 document.documentElement.clientWidth/clientHeight 的区别在哪
二者常被混淆,关键差异在于是否包含滚动条、是否受 zoom 影响:
window.innerWidth/Height:含垂直/水平滚动条占用空间(即已减去滚动条宽度),响应 CSSzoom(但现代 Chrome/Firefox 已弃用zoom,改用transform: scale(),此时它不变)document.documentElement.clientWidth/clientHeight:只读取根元素()的内联尺寸,不含滚动条,也不响应zoom;但在某些安卓 WebView 中可能更稳定- 如果页面有横向滚动(
overflow-x: auto),innerWidth仍等于视口宽度,而clientWidth可能略小(因内容撑开导致滚动条出现)
实际建议:优先用 innerWidth/Height,语义最准确;仅当需要排除滚动条影响做精确定位(如 tooltip 贴边)时,才对比使用 clientWidth。
服务端无法获取 innerWidth,别在 SSR 中硬读
Node.js 环境没有 window,innerWidth 是纯客户端 API。常见错误是在 Next.js / Nuxt 等框架的 getServerSideProps 或 setup() 中直接访问,会报 ReferenceError: window is not defined。
- 判断环境:
typeof window !== 'undefined'是最轻量的守卫,放在读取前即可 - 不要试图“预估”视口尺寸(比如靠 User-Agent 解析设备型号),误差极大;留到客户端首次渲染时再取
- 如果要做响应式降级(如服务端根据 UA 注入 class),只能依赖 HTTP header(如
Sec-CH-UA-Mobile)或客户端 JS 回传,不能靠innerWidth
真正容易被忽略的是:这些值在 Web Components 或 Shadow DOM 内部依然有效,但如果你在 slot 内容里动态计算位置,得确认 offsetParent 是否被 shadow boundary 阻断——innerWidth 本身不受影响,但它的用途可能失效。
到这里,我们也就讲完了《window.innerWidth和window.innerHeight是JavaScript中用于获取浏览器视口(viewport)宽度和高度的属性。它们返回的是浏览器窗口的可见区域尺寸,不包括浏览器工具栏、地址栏等非可视部分。1. 获取视口宽度和高度const width = window.innerWidth; const height = window.innerHeight; console.log("视口宽度:", width); console.log("视口高度:", height);2. 监听窗口大小变化如果你需要在窗口大小变化时动态获取视口尺寸,可以使用 resize 事件:window.addEventListener('resize', () => { const width = window.innerWidth; const height = window.innerHeight; console.log("视口宽度变化为:", width); console.log("视口高度变化为:", height); });3. 注意事项innerWidth 和 innerHeight 是只读属性,不能被修改。它们不包含滚动条的宽度或高度,只反映当前视口的可见区域。如果页面中有横向或纵向滚动,这些值不会自动更新,除非你手动监听 resize 事件。4. 示例:根据视口调整布局你可以结合这些属性来实现响应式布局: function adjustLayout() { const width = window.innerWidth; if (width
-
502 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
469 收藏
-
224 收藏
-
187 收藏
-
248 收藏
-
240 收藏
-
250 收藏
-
404 收藏
-
320 收藏
-
184 收藏
-
351 收藏
-
122 收藏
-
497 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习