JavaFX自动补全ComboBox清除选择后仅显示上次选中项问题

我帮你排查了下这个问题，根源在于你的AutoCompleteComboBoxListener实现里，每次做自动补全过滤时直接替换了ComboBox的items集合，把它改成了过滤后的小列表。当你点击提交按钮清除选择后，ComboBox的items并没有恢复成原始的完整数据集，所以下次打开时就只能看到上次过滤后剩下的选项了。

修复方案：改用FilteredList实现过滤（推荐） #

JavaFX提供了FilteredList，可以作为原始数据的过滤视图，这样既不会修改原始数据集，又能实现动态过滤。我们来改造你的AutoCompleteComboBoxListener：

import javafx.collections.FXCollections;
import javafx.collections.ObservableList;
import javafx.collections.transformation.FilteredList;
import javafx.event.EventHandler;
import javafx.scene.control.ComboBox;
import javafx.scene.input.KeyCode;
import javafx.scene.input.KeyEvent;

public class AutoCompleteComboBoxListener<T> implements EventHandler<KeyEvent> {
    private ComboBox<T> comboBox;
    private ObservableList<T> originalData;
    private FilteredList<T> filteredData;
    private boolean moveCaretToPos = false;
    private int caretPos;

    public AutoCompleteComboBoxListener(final ComboBox<T> comboBox) {
        this.comboBox = comboBox;
        this.originalData = comboBox.getItems();
        // 用FilteredList包装原始数据，作为ComboBox的items
        this.filteredData = new FilteredList<>(originalData, t -> true);
        this.comboBox.setItems(filteredData);
        
        this.comboBox.setEditable(true);
        this.comboBox.setOnKeyReleased(this);
        this.showOnFocus();
    }

    @Override
    public void handle(KeyEvent event) {
        if (event.getCode() == KeyCode.UP) {
            caretPos = -1;
            moveCaret(comboBox.getEditor().getText().length());
            return;
        } else if (event.getCode() == KeyCode.DOWN) {
            if (!comboBox.isShowing()) comboBox.show();
            caretPos = -1;
            moveCaret(comboBox.getEditor().getText().length());
            return;
        }

        // 忽略不影响输入的按键
        if (event.getCode() == KeyCode.RIGHT || event.getCode() == KeyCode.LEFT
                || event.isControlDown() || event.getCode() == KeyCode.HOME
                || event.getCode() == KeyCode.END || event.getCode() == KeyCode.TAB) {
            return;
        }

        comboBox.hide();

        if (event.getCode() == KeyCode.BACK_SPACE || event.getCode() == KeyCode.DELETE) {
            moveCaretToPos = true;
            caretPos = comboBox.getEditor().getCaretPosition();
        }

        String inputText = comboBox.getEditor().getText().toLowerCase();
        // 更新FilteredList的过滤条件，而不是替换items
        filteredData.setPredicate(item -> {
            if (inputText.isEmpty()) {
                return true; // 输入为空时显示所有项
            }
            return item.toString().toLowerCase().startsWith(inputText);
        });

        String currentText = comboBox.getEditor().getText();
        if (!moveCaretToPos) {
            caretPos = -1;
        }
        moveCaret(currentText.length());

        if (!filteredData.isEmpty()) {
            comboBox.show();
            // 保持编辑器文本不变，避免自动替换
            comboBox.getEditor().setText(currentText);
            moveCaret(currentText.length());
            // 可选：自动选中第一个匹配项
            comboBox.getSelectionModel().selectFirst();
        }

        if (event.getCode() == KeyCode.ENTER) {
            comboBox.hide();
            if (comboBox.getSelectionModel().getSelectedItem() != null) {
                comboBox.getEditor().setText(comboBox.getSelectionModel().getSelectedItem().toString());
            }
        }
    }

    private void moveCaret(int textLength) {
        if (caretPos == -1) {
            comboBox.getEditor().positionCaret(textLength);
        } else {
            comboBox.getEditor().positionCaret(caretPos);
        }
        moveCaretToPos = false;
    }

    public void showOnFocus() {
        this.comboBox.focusedProperty().addListener((obs, oldVal, newVal) -> {
            if (newVal) {
                this.comboBox.show();
            }
        });
    }
}

提交按钮代码优化 #

你的提交按钮里重复了两次clearSelection()，可以去掉一次，现在只需要清除选择即可，因为ComboBox的items始终是原始数据的过滤视图，下次输入时会自动重新过滤：

button.setOnAction(e-> { 
    combo1.getSelectionModel().clearSelection();
    // 可选：清空编辑器文本，这样下次打开会显示所有选项
    combo1.getEditor().clear();
});

关键改进点 #

• 不再直接替换ComboBox的items，而是用FilteredList包装原始数据，保持原始数据的完整性
• 过滤逻辑通过更新FilteredList的Predicate实现，动态筛选而不修改原始数据集
• 提交后清除选择并清空编辑器，下次打开ComboBox时会自动显示所有原始选项

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