如何恢复ControlsFX TableView2选中行的键盘导航功能？

问题背景 #

将JavaFX原生TableView替换为ControlsFX的TableView2后，表格箭头键导航功能完全失效：点击表格单元格并按下向下箭头键时，选中行不会下移，焦点反而跳转到界面中的TextField控件。原生TableView在相同代码逻辑下功能正常，该问题在ControlsFX Sampler应用中也可复现，且注意到SpreadsheetView组件默认具备正常的键盘导航样式。

环境配置：Windows 10 Pro 22H2、JDK corretto-17.0.7、JavaFX 20.0.1、controlsfx-11.1.2

原因分析 #

TableView2虽宣称是原生TableView的即插即用替代组件，但焦点事件处理逻辑与原生实现存在差异——它未正确拦截箭头键事件来处理行导航，导致事件冒泡到父容器或其他控件，触发焦点跳转而非表格行选择。此外，TableView2的默认单元格焦点策略和选择模式配置未对齐原生TableView的默认行为。

解决方案 #

1. 手动添加事件过滤器拦截箭头键 #

给TableView2添加KeyEvent过滤器，手动处理上下箭头的行导航逻辑，并消费事件阻止其冒泡到其他控件：

import javafx.scene.input.KeyCode;
import javafx.scene.input.KeyEvent;
import org.controlsfx.control.tableview2.TableView2;

// 假设tableView2是你的TableView2实例
tableView2.addEventFilter(KeyEvent.KEY_PRESSED, event -> {
    int currentSelectedIndex = tableView2.getSelectionModel().getSelectedIndex();
    int itemCount = tableView2.getItems().size();

    if (event.getCode() == KeyCode.DOWN) {
        if (currentSelectedIndex < itemCount - 1) {
            tableView2.getSelectionModel().select(currentSelectedIndex + 1);
            tableView2.scrollTo(currentSelectedIndex + 1);
            event.consume(); // 阻止事件继续传播
        }
    } else if (event.getCode() == KeyCode.UP) {
        if (currentSelectedIndex > 0) {
            tableView2.getSelectionModel().select(currentSelectedIndex - 1);
            tableView2.scrollTo(currentSelectedIndex - 1);
            event.consume();
        }
    }
    // 如需支持左右箭头切换列，可添加对应逻辑
});

2. 配置单元格焦点与选择模式 #

确保TableView2的单元格可获得焦点，同时设置正确的选择模式：

import javafx.scene.control.SelectionMode;
import javafx.scene.control.TableCell;
import org.controlsfx.control.tableview2.TableColumn2;

// 设置单选模式（原生TableView默认也是单选）
tableView2.getSelectionModel().setSelectionMode(SelectionMode.SINGLE);

// 自定义单元格工厂，确保单元格可被聚焦
tableView2.setCellFactory((TableColumn2<YourDataModel, ?> column) -> {
    TableCell<YourDataModel, Object> cell = new TableCell<>() {
        @Override
        protected void updateItem(Object item, boolean empty) {
            super.updateItem(item, empty);
            setText(empty || item == null ? null : item.toString());
        }
    };
    cell.setFocusTraversable(true); // 允许单元格获得焦点
    return cell;
});

3. 升级ControlsFX版本 #

当前使用的11.1.2版本可能存在该导航逻辑的bug，尝试升级到最新稳定版（如11.2.0或更高），新版本大概率修复了与原生组件行为对齐的问题。

验证 #

应用上述方案后，点击表格单元格并按下箭头键，确认选中行正常切换且焦点保持在表格内；若选择升级版本，替换依赖后重新运行程序，直接验证导航功能是否恢复原生TableView的表现。

内容的提问来源于stack exchange，提问作者bobndrew