Inertia.js React 组件 WhenVisible 的 params 参数失效问题分析

在 Inertia.js React 2.0.0-beta.1 版本中，开发者发现 WhenVisible 组件的 params 参数完全失效，无法正常传递数据。这个问题主要影响需要实现无限滚动加载功能的场景。

问题现象

WhenVisible 组件设计用于实现懒加载或无限滚动功能，其 params 参数本应允许开发者传递额外数据和控制逻辑。但在实际使用中，无论开发者如何配置 params 参数，该参数都不会产生任何效果。

典型的使用场景如下：

<WhenVisible
    always
    fallback={<SpinnerWithRetry/>}
    data='rooms'
    params={{
        data: {
            lastRoomId: rooms.data[rooms.data.length - 1].id
        },
        onBefore: async (data) => {
            console.log("onBefore", data);
        }
    }}
    children={null}
/>

技术背景

WhenVisible 组件是 Inertia.js 中用于实现视图内元素可见性检测的高阶组件，常用于：

• 无限滚动加载
• 图片懒加载
• 按需加载组件

params 参数的设计目的是为了：

1. 传递分页游标等附加数据
2. 提供加载前的回调钩子
3. 控制加载行为

问题根源

经过分析，这个问题与另一个已报告的问题(2025号)有相似之处，核心原因在于：

• params 参数的传递链路中断
• 内部状态管理未正确处理参数变更
• 生命周期钩子未被正确触发

解决方案

开发团队已经提交了修复该问题的 Pull Request，主要修改内容包括：

1. 修复参数传递链路
2. 确保状态更新时重新评估参数
3. 正确触发相关生命周期钩子

最佳实践建议

在等待官方修复发布期间，开发者可以考虑以下临时解决方案：

1. 使用外部状态管理控制加载逻辑
2. 手动实现可见性检测
3. 降级到稳定版本

对于无限滚动场景，也可以考虑：

const handleLoadMore = useCallback(() => {
    if (loading) return;
    setLoading(true);
    router.get(route('rooms.list'), {
        lastRoomId: rooms.data[rooms.data.length - 1].id
    }, {
        preserveScroll: true,
        preserveState: true,
        onFinish: () => setLoading(false)
    });
}, [rooms, loading]);

// 使用IntersectionObserver或其他方式触发handleLoadMore

总结

WhenVisible 组件的 params 参数失效问题影响了依赖该功能的高级交互场景。开发团队已意识到该问题并正在修复中。对于需要立即解决该问题的项目，可以采用替代方案或等待官方修复发布。这个问题也提醒我们在使用 beta 版本时需要更加谨慎，并及时关注相关问题的修复进展。