JavaFX TableView：为表格行动态添加Tooltip的实现指南

import javafx.beans.property.SimpleBooleanProperty;
import javafx.beans.property.SimpleStringProperty;

public class Model {
    private SimpleBooleanProperty flag;
    private SimpleStringProperty reason;

    public Model() {
        this.flag = new SimpleBooleanProperty(false); // 默认值
        this.reason = new SimpleStringProperty("");   // 默认值
    }

    public Model(boolean flag, String reason) {
        this.flag = new SimpleBooleanProperty(flag);
        this.reason = new SimpleStringProperty(reason);
    }

    public SimpleBooleanProperty flagProperty() {
        return flag;
    }

    public boolean getFlag() {
        return flag.get();
    }

    public void setFlag(boolean flag) {
        this.flag.set(flag);
    }

    public SimpleStringProperty reasonProperty() {
        return reason;
    }

    public String getReason() {
        return reason.get();
    }

    public void setReason(String reason) {
        this.reason.set(reason);
    }
}

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.TableColumn;
import javafx.scene.control.TableRow;
import javafx.scene.control.TableView;
import javafx.scene.control.Tooltip;
import javafx.scene.control.cell.CheckBoxTableCell;
import javafx.stage.Stage;

public class TableViewTooltipDemo extends Application {

    public static void main(String[] args) {
        launch(args);
    }

    @Override
    public void start(Stage primaryStage) throws Exception {
        TableView<Model> table = new TableView<>();

        // 添加一些示例数据
        table.getItems().add(new Model(true, "这是一个重要的选项，请仔细考虑。"));
        table.getItems().add(new Model(false, "此选项暂时不可用，原因待定。"));
        table.getItems().add(new Model(true, "已选中，无额外说明。"));
        table.getItems().add(new Model(false, "")); // 故意留空reason

        // 设置列
        TableColumn<Model, Boolean> column = new TableColumn<>("状态");
        column.setCellFactory(CheckBoxTableCell.forTableColumn(column));
        column.setCellValueFactory(features -> features.getValue().flagProperty());

        TableColumn<Model, String> reasonColumn = new TableColumn<>("说明");
        reasonColumn.setCellValueFactory(features -> features.getValue().reasonProperty());

        table.getColumns().addAll(column, reasonColumn);

        // 核心：设置TableRow工厂来添加Tooltip
        table.setRowFactory(tv -> {
            TableRow<Model> row = new TableRow<>();
            Tooltip tooltip = new Tooltip(); // 每个TableRow实例共用一个Tooltip实例

            row.itemProperty().addListener((obs, oldItem, newItem) -> {
                if (newItem != null && newItem.getReason() != null && !newItem.getReason().isEmpty()) {
                    tooltip.setText(newItem.getReason());
                    row.setTooltip(tooltip);
                } else {
                    row.setTooltip(null);
                }
            });

            return row;
        });

        // 优化后的TableRow工厂，使用属性绑定
        table.setRowFactory(tv -> new TableRow<>() {
            private Tooltip rowTooltip = new Tooltip(); // 为每个TableRow实例创建一个Tooltip

            @Override
            protected void updateItem(Model item, boolean empty) {
                super.updateItem(item, empty);
                if (empty || item == null) {
                    // 如果行是空的或者没有数据，则清除Tooltip
                    rowTooltip.textProperty().unbind(); // 解绑以避免内存泄漏
                    setTooltip(null);
                } else {
                    // 绑定Tooltip的文本到模型的reason属性
                    // 只有当reason不为空时才显示Tooltip
                    if (item.getReason() != null && !item.getReason().isEmpty()) {
                        rowTooltip.textProperty().bind(item.reasonProperty());
                        setTooltip(rowTooltip);
                    } else {
                        // 如果reason为空，则不显示Tooltip
                        rowTooltip.textProperty().unbind();
                        setTooltip(null);
                    }
                }
            }
        });


        final Scene scene = new Scene(table, 400, 300);
        primaryStage.setTitle("TableView Tooltip Demo");
        primaryStage.setScene(scene);
        primaryStage.show();
    }
}