本文介绍如何通过监听 wheel 事件，实现当鼠标悬停在支持垂直滚动的子容器上时优先触发其纵向滚动；仅当子容器已滚动至顶部或底部时，才将滚轮事件“透传”给父容器执行水平滚动，从而提供自然、符合直觉的嵌套滚动体验。
本文介绍如何通过监听 `wheel` 事件，实现当鼠标悬停在支持垂直滚动的子容器上时优先触发其纵向滚动；仅当子容器已滚动至顶部或底部时，才将滚轮事件“透传”给父容器执行水平滚动，从而提供自然、符合直觉的嵌套滚动体验。
在复杂 UI 布局中，常需构建「父容器水平滚动 + 子容器垂直滚动」的嵌套结构（例如横向时间轴中嵌入可上下滑动的详情卡片）。但默认情况下，鼠标滚轮会统一作用于最内层可滚动元素，无法智能切换——这会导致用户在子区域滚动到底部后仍继续向下滚，却无任何响应，体验割裂。
解决方案是主动拦截并分发 wheel 事件：通过判断 event.target 是否为子容器，并结合其滚动状态（scrollTop 与 scrollHeight / clientHeight 关系），动态决定滚动目标。
以下是核心逻辑的完整实现：
const parentDiv = document.getElementById('parentDiv');
const childDiv = document.getElementById('childDiv');
parentDiv.addEventListener('wheel', function(event) {
// 仅当鼠标指针位于 childDiv 内部时启用智能分发
if (event.target === childDiv || childDiv.contains(event.target)) {
const isScrolledToTop = childDiv.scrollTop === 0;
const isScrolledToBottom = childDiv.scrollHeight - childDiv.scrollTop <= childDiv.clientHeight;
if (event.deltaY > 0 && isScrolledToBottom) {
// 向下滚动且已到底 → 触发父容器向右滚动
parentDiv.scrollLeft += event.deltaY;
} else if (event.deltaY < 0 && isScrolledToTop) {
// 向上滚动且已在顶 → 触发父容器向左滚动
parentDiv.scrollLeft -= Math.abs(event.deltaY);
} else {
// 其余情况：由 childDiv 自行处理垂直滚动
childDiv.scrollTop += event.deltaY;
event.preventDefault(); // 阻止默认行为，避免父容器同时响应
return;
}
}
// 其他区域（如父容器空白处或兄弟元素）直接水平滚动
parentDiv.scrollLeft += event.deltaY;
event.preventDefault();
});? 关键细节说明：
- 使用
childDiv.contains(event.target)而非严格===，确保子元素内部任意后代（如<p></p>、<span></span>）触发滚轮也能正确识别； - 判断滚动到底部采用
scrollHeight - scrollTop （而非 <code>===），兼容因子内容高度计算误差或边框导致的微小偏差； - 水平滚动量直接复用
event.deltaY（正值向下 → 向右，负值向上 → 向左），保持方向一致性； -
必须调用
event.preventDefault()，否则浏览器可能同时触发默认滚动行为，造成冲突。
配套 CSS 需明确设置滚动模式与尺寸约束：
#parentDiv {
width: 600px;
height: 300px;
overflow-x: auto; /* 推荐 auto 而非 scroll，避免永远显示滚动条 */
white-space: nowrap;
border: 1px solid #ccc;
}
#childDiv {
width: 200px;
height: 300px;
overflow-y: auto;
display: inline-block;
vertical-align: top;
border: 1px solid #e74c3c;
}
.content {
padding: 16px;
height: 600px; /* 确保内容超出容器高度，启用垂直滚动 */
}✅ 最佳实践建议：
- 在真实项目中，建议封装为可复用的
useNestedScroll(parent, child)Hook（React）或自定义指令（Vue）； - 若需支持触摸板惯性滚动或 macOS 平滑滚动，可监听
event.deltaMode（DOM_DELTA_LINE/DOM_DELTA_PIXEL）做单位归一化； - 对于 Safari 等浏览器，注意
scrollLeft动画可能卡顿，可添加scroll-behavior: smooth或使用scrollTo({ left: ..., behavior: 'smooth' })提升体验。
通过该方案，用户可在子区域自由上下浏览，滑至边界时无缝过渡到横向导航，显著提升多维信息流界面的操作效率与沉浸感。
