iOS Safari 快速滚动时 DOM 元素消失并出现空白区域
结论
这更像是 iOS Safari/WebKit 在快速滚动长页面时的分块绘制与合成问题,React 或 MUI 的某个组件单独失效的可能性不大。你的复现里还叠着三处容易把问题放大的地方:body 被设置成主滚动容器(height: 100%、overflowY: auto、overscrollBehavior: contain、WebkitOverflowScrolling: touch),一次性渲染 1,000 个 DOM 节点,长内容外层又铺了大面积 linear-gradient 背景。建议先回退滚动容器和背景绘制,再评估是否真的需要虚拟化。不要一上来就给每个元素加 transform 或 will-change,那样可能增加层数量和内存占用,反而让问题更明显。
可能原因
- iOS Safari 对长滚动区域采用分块绘制和合成,快速轻扫时可能来不及补齐尚未绘制的区域,于是出现短暂空白。
- 当
body同时设置height: 100%和overflowY: auto时,页面可能变成非预期的滚动容器;移动端 WebKit 对文档滚动和内部滚动容器的处理差异,会把渲染延迟放大。 - 1,000 个块级元素各自带
padding、margin、border和交替背景色,绘制内容本来就不小;外层的大渐变背景还要覆盖整段滚动区域。 - MUI 的全局样式、
CssBaseline或主题styleOverrides如果也改了html/body的高度和 overflow,会和复现代码叠加。先确认最终计算样式。 user-select: none、WebkitTouchCallout: none这些属性本身未必是根因,但和滚动、触摸行为叠在一起时,应逐项回退验证。
解决步骤
1. 先让文档自然滚动
不要默认把 body 当成唯一滚动容器。长列表页面优先让 html/body 保持正常文档流,由浏览器处理视口滚动。可以先把全局样式改成类似这样:
const sharedGlobalStyles = {
styleOverrides: {
html: {},
body: {
boxSizing: 'border-box',
margin: 0,
padding: 0,
minHeight: '100vh',
height: 'auto',
width: '100%',
fontFamily: 'Roboto, sans-serif',
userSelect: 'none',
WebkitTouchCallout: 'none',
WebkitUserSelect: 'none',
overflow: 'visible',
},
},
};
如果业务必须使用内部滚动容器,再给该容器明确高度和 overflow: auto,但不要让 body 和内部容器同时承担滚动。overscrollBehavior: contain、WebkitOverflowScrolling: touch 可以先移除做对比测试;它们并非所有场景都需要。
2. 把大面积渐变从长列表父级移走
原来的复现里,<main> 覆盖 1,000 个条目并设置了整段渐变。测试时先改成纯色背景,看看空白是否和大面积背景绘制有关:
<main style={{ width: '100%', background: '#fff' }}>
{items}
</main>
如果必须保留渐变,可以把渐变放到固定背景层,避免它跟着超长内容反复绘制:
<main style={{ width: '100%', position: 'relative', background: '#fff' }}>
<div
aria-hidden
style={{
position: 'fixed',
inset: 0,
zIndex: -1,
background: 'linear-gradient(180deg, #fff, #bbb)',
pointerEvents: 'none',
}}
/>
{items}
</main>
这只是降低绘制压力的排查方向;iOS Safari 的空白不一定都来自背景。
3. 对长列表使用虚拟化
1,000 个简单节点在桌面端不算多,但在真机上快速滚动时仍可能触发 WebKit 的绘制延迟。实际业务里优先用窗口化列表,例如 react-window:
import { FixedSizeList as List } from 'react-window';
const Row = ({ index, style }) => (
<div style={style}>
<div
style={{
minHeight: '100px',
padding: '24px',
margin: '8px 12px',
backgroundColor: index % 2 === 0 ? '#fff' : '#e0e0e0',
border: '1px solid #999',
boxSizing: 'border-box',
}}
>
<h3>Element #{index + 1}</h3>
<p>iOS Safari fast scrolling test</p>
</div>
</div>
);
export default function ScrollTest() {
return (
<List height={window.innerHeight} itemCount={1000} itemSize={140} width='100%'>
{Row}
</List>
);
}
itemSize 要按真实行高调整;如果行高不固定,可以用 VariableSizeList 或 MUI 对应组件。虚拟化能明显减少同时存在的 DOM 节点数,但前提是滚动容器高度和行高计算正确。
4. 谨慎使用 CSS containment
对稳定的列表项,可以试试局部绘制隔离:
.scroll-row {
contain: layout paint;
}
contain: layout paint 能限制布局和绘制的影响范围,但不要用在含 position: sticky、溢出弹层或复杂阴影的节点上。也不要给 1,000 个条目批量写 will-change: transform,这会把大量元素提升为合成层,增加 GPU 内存压力。
5. 排查 MUI 全局样式和滚动容器
用 iOS Web Inspector 或 Safari 开发者工具检查最终计算样式,重点看 html、body 和实际滚动容器的 height、overflow、position、transform。可以临时移除 CssBaseline 或主题里的 styleOverrides 做对比,确认是否有全局样式把页面变成了内部滚动容器。如果用 Box 或 Paper 承担滚动,给滚动容器明确高度,并避免在滚动容器外层再套大面积固定背景或复杂滤镜。
注意事项
- 先在真机 iPhone 上验证,模拟器不一定能复现 WebKit 的滚动绘制行为。
- 不要同时改十几个 CSS 属性;按滚动容器、背景、DOM 数量逐项二分,才能定位触发条件。
- 如果问题只在快速轻扫时出现,滚动慢下来就恢复,先按渲染/合成压力排查,不必先怀疑 React 状态更新。
- 具体 iOS/Safari 版本和 MUI 版本不同,表现可能不同;未提供版本信息时,无法断言唯一根因。
备注:内容仅供参考。
