iOS H5页面高度闪烁问题与100vh兼容性详解

背景

在移动端H5开发中，常常会用 height: 100vh 让页面或某个容器铺满整个屏幕视口。然而在实际项目中，尤其是 iOS 设备（Safari、微信、抖音等内嵌WebView），经常会遇到页面高度“闪一下”或“塌陷”的问题，影响用户体验。

现象

• 页面初始加载正常，但手指按下页面时，页面高度突然变低，底部内容闪烁或跳动，随后又恢复。
• 输入框聚焦时，页面高度变得很小，内容被挤压。
• 滚动页面时，底部 position: fixed 的按钮忽隐忽现。
• 这些问题在PC端和大部分安卓设备上都不会出现，只在iOS H5页面上复现。

原因分析

1. iOS对100vh的实现方式

• iOS Safari 及其WebView对 100vh 的定义是“包含地址栏和底部工具栏的理论视口高度”，而不是“实际可见区域高度”。
• 当用户滚动、点击、输入等操作时，iOS会自动显示/隐藏地址栏和底部工具栏，导致视口高度动态变化。
• 这时，100vh 也会跟着变化，页面高度突变，出现闪烁或塌陷。

2. 具体表现

• 手指按下页面时，iOS会重新计算视口高度，100vh 变小，页面高度变低，底部内容闪烁。
• 软键盘弹出时，100vh 变得很小，页面内容被压缩。
• 滚动页面时，地址栏收起或展开，100vh 跟着变化，页面高度抖动。

解决方案

1. 用JS动态设置高度

核心思路：不用 100vh，而是用 window.innerHeight 作为页面实际高度。

实现方法

1. CSS默认高度

   .container {
     height: 100vh; /* 兜底，保证非JS环境下也有高度 */
   }
   

2. JS动态设置高度

   function setRealHeight() {
     const el = document.querySelector('.container');
     if (el) {
       el.style.height = window.innerHeight + 'px';
     }
   }
   window.addEventListener('resize', setRealHeight);
   window.addEventListener('orientationchange', setRealHeight);
   setRealHeight();
   

3. Vue/React等框架中可在 mounted/useEffect 时调用，并在组件销毁时移除事件监听。

2. 不要只在iOS下设置

• 一开始可能只在iOS下用JS设置高度，结果导致其他端页面塌陷（因为没有高度）。
• 建议所有端都用JS设置高度，这样最保险，兼容性最好。

3. 其他注意事项

• window.innerHeight 反映的是当前可视区域的实际像素高度，比 100vh 更准确。
• 安卓部分浏览器在软键盘弹出时也会缩小 window.innerHeight，如有输入框场景可做特殊处理。
• 如果页面有 position: fixed 的底部栏，务必用这种方式，否则会出现“底部闪烁”问题。

总结

• iOS H5页面高度闪烁、塌陷的根本原因是 100vh 单位兼容性差。
• 用JS动态设置容器高度为 window.innerHeight 是最通用的解决方案。
• 不要只在iOS下设置，否则其他端会塌陷。
• 这样可以保证页面在所有端都正常显示，用户体验更好。

参考资料：

• 100vh问题详解与解决方案
• MDN: window.innerHeight

如有更多移动端H5适配问题，欢迎留言交流！