本文讲解如何在页面刷新后仍能准确判断 dom 元素是否可水平滚动，并动态显示左右导航箭头，解决 `useeffect` 初始检查失效的问题。
在 React 中实现“仅当列表可滚动时才显示左右箭头”的交互效果时，一个常见陷阱是：页面首次加载或刷新后，滚动状态检测失效，导致箭头始终不显示。根本原因在于：useEffect 的空依赖数组 [] 确保了它只在组件挂载后执行一次，但此时 DOM 节点（尤其是通过 ref 绑定的元素）可能尚未完成渲染或尺寸计算——特别是当列表内容由异步数据、CSS 动画或字体加载延迟影响时，clientWidth/scrollWidth 可能返回 0 或不准确值，导致 isScrollableLeft 和 isScrollableRight 被错误初始化为 false。
✅ 正确做法：确保初始检测在 DOM 就绪后执行
关键改进有两点：
- 将 checkScrollable 提取为稳定函数（避免因内联定义导致 useEffect 依赖变化）；
- 移除空依赖数组，改用 [checkScrollable] —— 这看似反直觉，实则利用了 React 的依赖校验机制：由于 checkScrollable 是稳定引用（无闭包依赖外部变量），[checkScrollable] 等效于“仅在挂载时运行”，同时强制 React 在 ref 绑定完成、布局渲染完毕后再执行该函数（尤其在严格模式下更可靠）。
以下是优化后的完整代码：
const [isScrollableLeft, setIsScrollableLeft] = useState(false);
const [isScrollableRight, setIsScrollableRight] = useState(false);
const listRef = useRef<HTMLUListElement>(null);
const checkScrollable = () => {
const el = listRef.current;
if (!el) return;
const { scrollLeft, scrollWidth, clientWidth } = el;
setIsScrollableLeft(scrollLeft > 0);
setIsScrollableRight(scrollWidth > clientWidth + scrollLeft);
};
useEffect(() => {
// ✅ 立即执行初始检测（DOM 已就绪）
checkScrollable();
const el = listRef.current;
if (el) {
el.addEventListener('scroll', checkScrollable);
}
return () => {
if (el) {
el.removeEventListener('scroll', checkScrollable);
}
};
}, [checkScrollable]); // 依赖稳定函数，保证仅挂载时运行⚠️ 注意事项与增强建议
- 避免 useLayoutEffect 误用：虽然 useLayoutEffect 能在浏览器绘制前读取尺寸，但此处无需强制同步——useEffect + 稳定依赖已足够；过度使用可能引发性能问题。
-
响应式重检测：若列表宽度随窗口缩放变化（如 flex-wrap 或媒体查询），需监听 resize 事件并再次调用 checkScrollable：
useEffect(() => { const handleResize = () => requestAnimationFrame(checkScrollable); window.addEventListener('resize', handleResize); return () => window.removeEventListener('resize', handleResize); }, [checkScrollable]); - 防抖滚动事件（可选）：高频滚动可能触发多次状态更新，可添加轻量防抖（如 setTimeout 延迟 50ms）提升性能。
- 服务端渲染（SSR）兼容性：若使用 Next.js 等框架，确保 listRef.current 存在再访问属性，避免 SSR 时 undefined 报错。
✅ 总结
页面刷新后滚动检测失效，本质是时机问题而非逻辑错误。通过将检测函数提取为稳定依赖，并利用 useEffect 的依赖校验机制，可确保检测逻辑在 DOM 完全就绪后精准执行。这一模式适用于所有需要基于 DOM 尺寸做初始判断的场景（如自动滚动到激活项、动态分页按钮等），是 React 中处理“渲染后测量”的最佳实践之一。
