Vaadin Grid 未确认导航时如何阻止选中新条目
Vaadin Grid 实现选中变更拦截的方案
问题根源
Vaadin Grid的选中状态更新优先级高于SelectionListener回调:用户点击新条目时,Grid会先把选中态切换到目标条目,再触发监听器的业务逻辑。这就导致在监听器里弹出确认框、用户点击取消时,选中态已经停留在新条目上,因为后续没有对应的详情加载触发逻辑,就会出现需要再次点击才能正常切换的问题。
具体实现逻辑
- 预先维护两个业务状态变量:
currentValidSelected:记录当前已同步加载详情、抽屉保持打开状态的有效选中条目pendingSelected:记录用户点击Grid时触发的临时待选中条目,也就是尚未走完确认流程的目标值
- 增加回退防护标记:设置
isRollingBack布尔标识,用来标记当前是否在执行手动回退选中的操作,避免回退动作反复触发SelectionListener造成逻辑死循环 - 重写Grid的SelectionListener处理流程:
- 监听到选中变更事件时,首先判断当前是否处于回退流程,如果是则直接跳过后续处理逻辑
- 从事件中提取用户点击触发的新选中值,赋值给
pendingSelected - 校验当前详情抽屉是否存在未保存的修改:
- 如果存在未保存修改,第一时间手动将Grid的选中状态回退为
currentValidSelected,再弹出离页确认对话框 - 如果不存在未保存修改,直接将
currentValidSelected更新为新选中值,加载对应条目详情到抽屉
- 如果存在未保存修改,第一时间手动将Grid的选中状态回退为
- 绑定确认对话框的按钮回调:
- 用户点击「确认离开」:正式将
currentValidSelected更新为pendingSelected,同步更新Grid选中态,加载新条目的详情内容 - 用户点击「中止/取消」:清空
pendingSelected的临时值,保持Grid选中态为原有的有效选中值,抽屉内容不做任何变更
- 用户点击「确认离开」:正式将
参考代码示例
// 回退防护标记,避免循环触发监听器 private boolean isRollingBack = false; // 当前已生效的有效选中条目 private ProjectItem currentValidItem; // 待确认的临时选中条目 private ProjectItem pendingItem; grid.addSelectionListener(event -> { // 回退操作触发的选中变更,直接跳过逻辑 if (isRollingBack) { return; } pendingItem = event.firstSelectedItem().orElse(null); // 判断详情表单是否存在未保存修改 if (detailForm.hasUnsavedChanges()) { // 立刻回退选中态到原有值 isRollingBack = true; grid.setValue(currentValidItem); isRollingBack = false; // 弹出离页确认对话框 leaveConfirmDialog.open( "当前存在未保存的修改,确认切换条目?", // 确认按钮的执行逻辑 () -> { currentValidItem = pendingItem; grid.setValue(pendingItem); detailDrawer.loadItem(pendingItem); }, // 取消按钮的执行逻辑 () -> { pendingItem = currentValidItem; } ); } else { // 无未保存修改,直接生效选中 currentValidItem = pendingItem; detailDrawer.loadItem(pendingItem); } });
实操注意点
- 回退选中态的操作必须在弹出确认框之前完成,避免用户看到选中态闪烁跳转的异常体验
- 回退操作必须搭配状态标记使用,否则手动设置Grid选中值会再次触发SelectionListener,导致反复弹出确认框
- 不建议用临时禁用Grid交互的方式实现拦截,这种方式会让用户点击时没有任何界面反馈,交互体验很差
内容的提问来源于stack exchange,提问作者AnjaM
相关产品推荐
相关产品推荐

