JavaFX TableView可编辑单元格问题：setEditable无效及编辑值无法保存

初始问题：单元格无法编辑 #

项目中使用TableView，单元格需放入长文本，既要实现文本换行又要支持编辑。编写了如下代码：

tcHelp.setCellValueFactory(new PropertyValueFactory<Help, String>("Description"));
tcHelp.setCellFactory(TextFieldTableCell.forTableColumn());

tcHelp.setCellFactory(new Callback<TableColumn<Help, String>, TableCell<Help, String>>() {

    @Override
    public TableCell<Help, String> call(TableColumn<Help, String> param) {
        final TableCell<Help, String> cell = new TableCell<Help, String>() {

            private Text text;
            @Override
            public void updateItem(String item, boolean empty) {
                super.updateItem(item, empty);
                if (!isEmpty()) {
                    Help rowItem = getTableRow().getItem();
                    text = new Text(rowItem.getDescription());
                    text.setWrappingWidth(440);
                    setGraphic(text);
                }
            }
        };
                
        // 不生效！！
        cell.setEditable(true);
                
        return cell;
    }
});

设置cell.setEditable(true)后单元格仍无法编辑，问题出在哪里？

补充问题：编辑后值无法保存，setOnEditCommit不触发 #

根据建议修改代码后，仍无法保存编辑值，setOnEditCommit始终未被调用：

tcHelp.setCellFactory(new Callback<TableColumn<Help, String>, TableCell<Help, String>>() {
    @Override
    public TableCell<Help, String> call(TableColumn<Help, String> param) {
        final TableCell<Help, String> cell = new TableCell<Help, String>() {

            private TextArea textArea;

            @Override
            public void updateItem(String item, boolean empty) {
                super.updateItem(item, empty);
                if (!isEmpty()) {
                    Help rowItem = getTableRow().getItem();
                    String text= rowItem.getDescription();
                    Text t = new Text(text);
                    textArea = new TextArea(text);
                    textArea.setWrapText(true);
                    double height = t.getLayoutBounds().getHeight();
                    textArea.setPrefHeight(height+10);
                    setGraphic(textArea);
                }
            }
        };
        cell.setEditable(true);

        return cell;
    }
});

编辑提交事件代码：

tcHelp.setOnEditCommit(new EventHandler<TableColumn.CellEditEvent<Help, String>>() {

    @Override
    public void handle(TableColumn.CellEditEvent<Help, String> t) {
        ((Help) t.getTableView().getItems().get(t.getTablePosition().getRow())).setDescription(t.getNewValue());
    }
});

问题原因与解决方法 #

1. 初始代码无法编辑的核心原因 #

• 两次调用setCellFactory：第二次自定义TableCell会覆盖第一次的TextFieldTableCell实现，而你的自定义TableCell仅用Text显示文本，没有实现编辑模式的触发逻辑（比如双击进入编辑、切换编辑状态的UI切换），即使设置setEditable(true)也没有编辑入口。
• updateItem中直接通过getTableRow().getItem()获取数据，未使用方法传入的item参数，不符合TableCell设计规范，容易引发空指针或数据不一致问题。

2. TextArea版本setOnEditCommit不触发的原因 #

自定义TableCell没有和TableView的编辑机制绑定：

• 仅把TextArea作为静态Graphic显示，未实现编辑状态切换逻辑（进入编辑时显示TextArea，退出时恢复文本显示）。
• 未监听TextArea的输入完成事件（回车、失去焦点），也未重写TableCell的commitEdit方法主动触发编辑提交事件，导致setOnEditCommit无法接收到事件。

3. 正确实现方案 #

以下是完整的自定义TableCell代码，同时实现换行显示与编辑功能，并确保编辑提交事件正常触发：

tcHelp.setCellValueFactory(new PropertyValueFactory<Help, String>("Description"));
tcHelp.setCellFactory(col -> new TableCell<Help, String>() {
    private Text text;
    private TextArea textArea;

    @Override
    protected void updateItem(String item, boolean empty) {
        super.updateItem(item, empty);
        if (empty || item == null) {
            setGraphic(null);
            return;
        }

        // 非编辑状态：用Text显示换行文本
        if (!isEditing()) {
            text = new Text(item);
            text.setWrappingWidth(440);
            setGraphic(text);
        } else {
            // 编辑状态：用TextArea支持换行编辑
            textArea = new TextArea(item);
            textArea.setWrapText(true);
            // 自适应文本高度
            Text tempText = new Text(item);
            tempText.setWrappingWidth(440);
            textArea.setPrefHeight(tempText.getLayoutBounds().getHeight() + 20);
            textArea.setMinHeight(Region.USE_PREF_SIZE);
            textArea.setMaxHeight(Region.USE_PREF_SIZE);
            
            // 回车提交编辑
            textArea.setOnAction(e -> commitEdit(textArea.getText()));
            // 失去焦点提交编辑
            textArea.focusedProperty().addListener((obs, oldVal, newVal) -> {
                if (!newVal) {
                    commitEdit(textArea.getText());
                }
            });
            
            setGraphic(textArea);
            textArea.selectAll();
        }
    }

    @Override
    public void startEdit() {
        super.startEdit();
        // 进入编辑时更新UI
        updateItem(getItem(), isEmpty());
    }

    @Override
    public void cancelEdit() {
        super.cancelEdit();
        // 取消编辑时恢复文本显示
        updateItem(getItem(), isEmpty());
    }

    @Override
    public void commitEdit(String newValue) {
        super.commitEdit(newValue);
        // 手动触发编辑提交事件，让setOnEditCommit能接收
        if (newValue != null) {
            TableColumn.CellEditEvent<Help, String> event = new TableColumn.CellEditEvent<>(
                    getTableView(),
                    new TablePosition<>(getTableView(), getIndex(), getTableColumn()),
                    TableColumn.editCommitEvent(),
                    newValue
            );
            fireEvent(event);
        }
    }
});

// 处理编辑提交，保存值到数据源
tcHelp.setOnEditCommit(t -> {
    Help help = t.getTableView().getItems().get(t.getTablePosition().getRow());
    help.setDescription(t.getNewValue());
});

关键实现要点：

• 重写startEdit()、cancelEdit()、commitEdit()方法，绑定TableView的编辑生命周期。
• 区分非编辑/编辑状态，分别用Text和TextArea显示内容。
• 给TextArea添加事件监听，在回车或失去焦点时主动提交编辑。
• 在commitEdit()中手动构造并触发CellEditEvent，确保setOnEditCommit能正常接收事件。

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