如何基于单个单元格值格式化JavaFX TableView整行样式？

我在JavaFX中使用TableView，目前已实现基于单元格值设置单元格样式（代码如下）。现想了解是否可基于某一单元格的值或对象属性（如step.getStatus()），对该单元格所属的整行进行样式格式化。

colStatus.setCellFactory(new Callback<TableColumn<Step, String>, TableCell<Step, String>>()
    {
        @Override
        public TableCell<Step, String> call(TableColumn<Step, String> param) {
            return new TableCell<Step, String>() {
                @Override
                protected void updateItem(String item, boolean empty) {
                    if (!empty) {
                        int currentIndex = indexProperty().getValue() < 0 ? 0 : indexProperty().getValue();
                        setText(param.getTableView().getItems().get(currentIndex).getStatus().name());
                        switch(param.getTableView().getItems().get(currentIndex).getStatus())
                        {
                            case Step.STATUS.Enabled:
                                setTextFill(Color.BLACK);
                                break;
                            case Step.STATUS.Disabled:
                                setTextFill(Color.GRAY);
                                break;
                            case Step.STATUS.Running:
                                setTextFill(Color.BLUEVIOLET);
                                break;
                            case Step.STATUS.Complete:
                                setTextFill(Color.LIME);
                                break;
                            case Step.STATUS.Error:
                                setTextFill(Color.RED);
                                setStyle("-fx-background-color: pink;");
                                break;
                        }                
                    }
                }
            };
        }
    });

实现方案 #

方法一：通过rowFactory直接设置行样式 #

给TableView自定义行工厂，直接根据行数据的Status属性设置整行样式：

tableView.setRowFactory(tv -> new TableRow<Step>() {
    @Override
    protected void updateItem(Step step, boolean empty) {
        super.updateItem(step, empty);
        // 重置旧样式，避免行复用导致样式残留
        setStyle("");
        
        if (step != null && !empty) {
            switch(step.getStatus()) {
                case Enabled:
                    setStyle("-fx-text-fill: black;");
                    break;
                case Disabled:
                    setStyle("-fx-text-fill: gray;");
                    break;
                case Running:
                    setStyle("-fx-text-fill: blueviolet;");
                    break;
                case Complete:
                    setStyle("-fx-text-fill: lime;");
                    break;
                case Error:
                    setStyle("-fx-background-color: pink; -fx-text-fill: red;");
                    break;
            }
        }
    }
});

注意：必须调用super.updateItem(step, empty)，且每次更新时清空旧样式——TableRow会被TableView复用，不清理会导致旧样式保留在新数据行上。

方法二：结合CSS伪类（推荐，样式与代码分离） #

将样式逻辑从Java代码中剥离，用CSS伪类实现，更易维护：

1. Java代码中注册并切换伪类：

// 定义对应状态的伪类
PseudoClass enabledClass = PseudoClass.getPseudoClass("enabled");
PseudoClass disabledClass = PseudoClass.getPseudoClass("disabled");
PseudoClass runningClass = PseudoClass.getPseudoClass("running");
PseudoClass completeClass = PseudoClass.getPseudoClass("complete");
PseudoClass errorClass = PseudoClass.getPseudoClass("error");

tableView.setRowFactory(tv -> new TableRow<Step>() {
    @Override
    protected void updateItem(Step step, boolean empty) {
        super.updateItem(step, empty);
        // 重置所有伪类状态
        pseudoClassStateChanged(enabledClass, false);
        pseudoClassStateChanged(disabledClass, false);
        pseudoClassStateChanged(runningClass, false);
        pseudoClassStateChanged(completeClass, false);
        pseudoClassStateChanged(errorClass, false);
        
        if (step != null && !empty) {
            switch(step.getStatus()) {
                case Enabled:
                    pseudoClassStateChanged(enabledClass, true);
                    break;
                case Disabled:
                    pseudoClassStateChanged(disabledClass, true);
                    break;
                case Running:
                    pseudoClassStateChanged(runningClass, true);
                    break;
                case Complete:
                    pseudoClassStateChanged(completeClass, true);
                    break;
                case Error:
                    pseudoClassStateChanged(errorClass, true);
                    break;
            }
        }
    }
});

2. 在CSS文件中定义对应样式：

.table-row-cell:enabled {
    -fx-text-fill: black;
}
.table-row-cell:disabled {
    -fx-text-fill: gray;
}
.table-row-cell:running {
    -fx-text-fill: blueviolet;
}
.table-row-cell:complete {
    -fx-text-fill: lime;
}
.table-row-cell:error {
    -fx-background-color: pink;
    -fx-text-fill: red;
}

这种方式将样式规则集中在CSS中，后续修改样式无需改动Java代码，符合关注点分离原则。

关键注意事项 #

• 必须处理empty和step == null的情况，避免空指针异常。
• TableRow复用机制导致样式会残留，一定要在updateItem中重置样式或伪类状态。
• 单元格样式优先级高于行样式，如果整行样式已满足需求，可移除之前的单元格样式逻辑，避免冲突。

内容的提问来源于stack exchange，提问作者M. Rogers