ControlsFX调用dispose()无法解除TextField与AutoCompletionBinding绑定的问题

原代码的核心问题是反复创建AutoCompletionBinding实例——每次输入字符长度达标时都新建绑定，但之前的绑定并没有被彻底清理，导致即使调用dispose()，旧绑定的监听器仍可能残留并触发建议显示。

不需要反复创建和销毁绑定，只需一次性绑定，通过动态过滤输入内容来控制建议是否显示。利用ControlsFX提供的TextFields.bindAutoCompletion重载方法，传入一个Callback来按需返回建议列表即可解决问题。

完整代码示例 #

import javafx.collections.FXCollections;
import javafx.collections.ObservableList;
import javafx.fxml.FXML;
import javafx.scene.control.TextField;
import org.controlsfx.control.textfield.AutoCompletionBinding;
import org.controlsfx.control.textfield.TextFields;
import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;

public class TestView {

    @FXML
    private TextField name;
    private AutoCompletionBinding<String> acb;

    @FXML
    public void initialize() {
        String[] suggestions = {"ciao", "12345", "abcdefg"};
        List<String> suggestionList = Arrays.asList(suggestions);

        // 一次性完成绑定，通过回调逻辑控制建议是否显示
        acb = TextFields.bindAutoCompletion(name, request -> {
            String input = request.getUserText();
            // 仅当输入长度≥3时返回匹配建议，否则返回空列表
            if (input.length() >= 3) {
                return FXCollections.observableArrayList(
                    suggestionList.stream()
                        .filter(s -> s.toLowerCase().contains(input.toLowerCase()))
                        .collect(Collectors.toList())
                );
            } else {
                return FXCollections.emptyObservableList();
            }
        });
    }

    // 可选：在视图销毁时清理绑定资源
    public void cleanup() {
        if (acb != null) {
            acb.dispose();
        }
    }
}

代码说明 #

• 初始化阶段仅完成一次绑定，避免多次创建绑定导致的资源残留
• 在Callback逻辑中，直接根据当前输入长度判断是否返回建议：
  • 输入长度≥3时，返回与输入内容匹配的建议列表（示例使用大小写不敏感的包含匹配，可根据需求调整匹配规则）
  • 输入长度不足3时，返回空列表，自动补全面板不会弹出
• 可在视图销毁的生命周期方法中调用cleanup()，确保绑定资源被正确释放

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