登录
首页 >  文章 >  前端

window.innerWidth和window.innerHeight是JavaScript中用于获取浏览器视口(viewport)宽度和高度的属性。它们返回的是浏览器窗口的可见区域尺寸,不包括浏览器工具栏、地址栏等非可视部分。1. 获取视口宽度和高度const width = window.innerWidth; const height = window.innerHeight; cons

时间:2026-05-19 21:24:37 173浏览 收藏

推广推荐
前往下载Windows工具 ➜
支持 PC / 移动端,安全直达
window.innerWidth 和 window.innerHeight 是前端开发中获取浏览器可视区域尺寸的核心API,它们以CSS像素为单位精确反映用户当前可见的视口宽高(已扣除滚动条占用空间,但受缩放影响),广泛应用于响应式布局、动态适配和交互优化;然而其行为在移动端(如Safari地址栏展开/旋转)、iframe上下文、SSR环境及旧版IE中存在诸多陷阱,需配合resize事件监听、节流处理、环境判断和与clientWidth/clientHeight的合理选用来确保稳定可靠——掌握这些细节,才能真正让“所见即所得”的响应式体验落地无误。

怎么利用HTML的window.innerWidth和innerHeight获取视口的宽度高度

直接读取 window.innerWidthwindow.innerHeight 就行,但要注意它们返回的是 CSS 像素,不是设备物理像素

这两个属性在绝大多数现代浏览器中都可用,返回当前视口(即用户可见区域)的宽高,单位是 CSS 像素。比如在桌面浏览器缩放为 125% 时,window.innerWidth 会比实际屏幕宽度小,因为它反映的是“渲染后可见多少个 CSS 像素”,而不是设备像素数。

常见错误现象:
– 在 iOS Safari 横屏旋转后首次读取,值没更新(需监听 resize
– 误以为它包含滚动条宽度(实际上已扣除垂直滚动条宽度)
– 在 iframe 中调用却忘了上下文:它始终返回**调用者所在窗口**的视口尺寸,不是父页面的

  • 不要在页面加载前就取值(如 script 标签放在 且没加 defer),DOM 可能未就绪,但 window 对象已存在,所以通常安全;不过若依赖布局(比如配合 getBoundingClientRect),建议等 DOMContentLoaded
  • 移动端注意:Safari 地址栏收起/展开会触发 resizeinnerHeight 会变化,不能假设它固定
  • 不支持 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 },也建议用 setTimeoutrequestAnimationFrame 包一层,避免每毫秒都计算
  • 在单页应用(SPA)中,路由切换可能不触发 resize,但视口实际没变——这时候不需要重新获取,别为了“保险”而重复读取

innerWidth/Heightdocument.documentElement.clientWidth/clientHeight 的区别在哪

二者常被混淆,关键差异在于是否包含滚动条、是否受 zoom 影响:

  • window.innerWidth/Height:含垂直/水平滚动条占用空间(即已减去滚动条宽度),响应 CSS zoom(但现代 Chrome/Firefox 已弃用 zoom,改用 transform: scale(),此时它不变)
  • document.documentElement.clientWidth/clientHeight:只读取根元素()的内联尺寸,不含滚动条,也不响应 zoom;但在某些安卓 WebView 中可能更稳定
  • 如果页面有横向滚动(overflow-x: auto),innerWidth 仍等于视口宽度,而 clientWidth 可能略小(因内容撑开导致滚动条出现)

实际建议:优先用 innerWidth/Height,语义最准确;仅当需要排除滚动条影响做精确定位(如 tooltip 贴边)时,才对比使用 clientWidth

服务端无法获取 innerWidth,别在 SSR 中硬读

Node.js 环境没有 windowinnerWidth 是纯客户端 API。常见错误是在 Next.js / Nuxt 等框架的 getServerSidePropssetup() 中直接访问,会报 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

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>