如何为JavaFX VirtualFlow设置ObservableList数据？

JavaFX原生VirtualFlow没有提供Flowless那样直接的setItems方法，需要通过以下方式完成数据源绑定：

1. 完善VirtualCell的内容渲染逻辑 #

必须重写IndexedCell的updateItem方法，根据单元格索引从数据源中获取数据并显示：

public class VirtualCell<T> extends IndexedCell<T> {
    private final Label label = new Label();

    public VirtualCell() {
        getChildren().add(label);
        setPrefHeight(20); // 设置单元格固定高度，方便VirtualFlow计算可见区域
    }

    @Override
    protected void updateItem(T item, boolean empty) {
        super.updateItem(item, empty);
        // 处理空单元格或无数据的情况
        if (empty || item == null) {
            label.setText("");
        } else {
            label.setText(item.toString());
        }
    }
}

2. 绑定ObservableList到VirtualFlow #

需要手动设置项数并监听列表变化，确保数据更新时VirtualFlow同步响应：

public class NewMain extends Application {

    public class VirtualCell<T> extends IndexedCell<T> {
        private final Label label = new Label();

        public VirtualCell() {
            getChildren().add(label);
            setPrefHeight(20);
        }

        @Override
        protected void updateItem(T item, boolean empty) {
            super.updateItem(item, empty);
            if (empty || item == null) {
                label.setText("");
            } else {
                label.setText(item.toString());
            }
        }
    }

    private final VirtualFlow<VirtualCell<String>> virtualFlow = new VirtualFlow<>();
    private ObservableList<String> items;

    @Override
    public void start(Stage primaryStage) {
        this.virtualFlow.setCellFactory(v -> new VirtualCell<>());
        
        // 初始化数据源
        List<String> list = new ArrayList<>();
        for (var i = 0; i < 100; i++) {
            list.add("Item " + i);
        }
        items = FXCollections.observableArrayList(list);
        
        // 设置VirtualFlow的总项数，这是虚拟滚动的核心参数
        virtualFlow.setCellCount(items.size());
        
        // 监听数据源变化，同步更新项数并处理滚动边界
        items.addListener((ListChangeListener.Change<? extends String> change) -> {
            virtualFlow.setCellCount(items.size());
            if (virtualFlow.getFirstVisibleCellIndex() >= items.size()) {
                virtualFlow.scrollTo(items.size() - 1);
            }
        });

        virtualFlow.setPrefHeight(200);
        var root = new VBox(this.virtualFlow);
        Scene scene = new Scene(root, 600, 200);
        primaryStage.setScene(scene);
        primaryStage.show();
    }

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

关键说明 #

• setCellCount(int)：告诉VirtualFlow总共有多少个项，是虚拟滚动功能生效的基础；
• 监听ObservableList的ListChangeListener：当数据增删时自动更新项数，保证VirtualFlow显示与数据源一致；
• updateItem方法：必须调用super.updateItem，同时处理空数据场景，避免渲染异常；
• 固定单元格高度：帮助VirtualFlow计算可见区域内需要渲染的单元格数量，优化性能。

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