如何设置JavaFX TableView滚动条触发时填充列区域的背景色

问题说明 #

当TableView启用CONSTRAINED_RESIZE_POLICY_ALL_COLUMNS列自适应策略，且垂直滚动条显示时，表格列右侧会出现一块填充空白区域（即你提到的滚动条旁的填充列区域），需要自定义该区域的背景色。

实现方案 #

1. CSS样式实现（推荐） #

TableView的填充区域对应CSS选择器为.table-view > .filler，直接通过CSS设置背景色即可：

.table-view > .filler {
    -fx-background-color: #f5f5f5; /* 替换为你需要的目标颜色值 */
}

可以将上述代码写入独立的CSS文件，再通过TableView加载：

test.getStylesheets().add("styles/table-style.css"); // 替换为你的CSS文件实际路径

也可以直接通过代码内联设置样式：

test.setStyle(".table-view > .filler { -fx-background-color: #f5f5f5; }");

2. 代码直接定位节点设置 #

如果偏好纯Java代码实现，需在界面渲染完成后查找filler节点并设置样式：

stage.show(); // 必须先显示界面，确保节点已完成渲染
Node filler = test.lookup(".filler");
if (filler != null) {
    filler.setStyle("-fx-background-color: #f5f5f5;");
}

完整示例代码 #

record Person(String name, int age) {
}

@Override
public void start(Stage stage) {
    TableView<Person> test = new TableView<>();
    test.setColumnResizePolicy(TableView.CONSTRAINED_RESIZE_POLICY_ALL_COLUMNS);

    // 初始化列
    TableColumn<Person, String> nameColumn = new TableColumn<>("Name");
    nameColumn.setCellValueFactory(p -> new SimpleStringProperty(p.getValue().name));

    TableColumn<Person, Integer> ageColumn = new TableColumn<>("Age");
    ageColumn.setCellValueFactory(person -> new SimpleIntegerProperty(person.getValue().age).asObject());

    test.getColumns().addAll(nameColumn, ageColumn);

    // 加载测试数据
    ObservableList<Person> data = FXCollections.observableArrayList(
            new Person("John Doe", 30),
            new Person("Jane Doe", 28),
            new Person("Michael Smith", 35),
            new Person("Emma Johnson", 22),
            new Person("Olivia Williams", 27),
            new Person("Noah Brown", 31),
            new Person("Liam Jones", 29),
            new Person("Mason Garcia", 26),
            new Person("Lucas Miller", 24),
            new Person("Ethan Davis", 32),
            new Person("Ava Martinez", 21),
            new Person("Sophia Rodriguez", 25)
    );
    test.setItems(data);

    test.setMinHeight(500);
    // 内联设置填充区域背景色
    test.setStyle(".table-view > .filler { -fx-background-color: #e8e8e8; }");

    stage.setScene(new Scene(test));
    stage.show();
}

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