JavaFX自动补全TextField：方向键控制ContextMenu的问题与需求

我来帮你梳理并解决这几个棘手的交互问题：

1. 向下键二次无响应的原因与修复 #

你遇到的第二次按下向下键没反应的问题，核心原因是在ContextMenu刚调用show()后立刻通过lookup(".menu-item")获取节点并请求焦点的时机不对——此时ContextMenu的UI节点可能还没完全渲染完成，导致焦点设置失效或者出现异常状态。

替代方案是：利用ContextMenu的showingProperty监听菜单显示完成的时机，再通过Platform.runLater延迟设置焦点，直接操作菜单的第一个Item来请求焦点，而不是依赖不可靠的lookup方法。

2. 实现选中第一项时按向上键隐藏菜单 #

我们可以给ContextMenu添加一个事件过滤器，监听键盘事件。当检测到向上键（UP）且当前焦点在第一个MenuItem时，就隐藏菜单并消费该事件，避免事件传递到TextField。

3. 禁止空格键触发MenuItem的onAction #

同样在事件过滤器中，检测到空格键（SPACE）时直接消费事件，不让它触发MenuItem的onAction逻辑。

修改后的完整AutoCompleteTextField代码 #

import javafx.application.Platform;
import javafx.geometry.Side;
import javafx.scene.control.ContextMenu;
import javafx.scene.control.CustomMenuItem;
import javafx.scene.control.Label;
import javafx.scene.control.TextField;
import javafx.scene.input.KeyCode;
import javafx.scene.input.KeyEvent;

public class AutoCompleteTextField extends TextField {
    private ContextMenu suggestionMenu;

    public AutoCompleteTextField() {
        super();
        suggestionMenu = new ContextMenu();

        // 初始化建议项
        for (int i = 0; i < 5; i++) {
            CustomMenuItem item = new CustomMenuItem(new Label("Item " + i), true);
            item.setOnAction(event -> {
                setText("selected");
                positionCaret(getText().length());
                suggestionMenu.hide();
            });
            suggestionMenu.getItems().add(item);
        }

        // 文本变化时显示/隐藏菜单
        textProperty().addListener((observable, oldValue, newValue) -> {
            if (getText().length() > 0) {
                if (!suggestionMenu.isShowing()) {
                    suggestionMenu.show(AutoCompleteTextField.this, Side.BOTTOM, 0, 0);
                }
            } else {
                suggestionMenu.hide();
            }
        });

        // 监听向下键显示菜单并设置焦点
        setOnKeyPressed(event -> {
            System.out.println("pressed " + event.getCode());
            if (event.getCode() == KeyCode.DOWN && getText().length() > 0) {
                if (!suggestionMenu.isShowing()) {
                    suggestionMenu.show(AutoCompleteTextField.this, Side.BOTTOM, 0, 0);
                } else {
                    // 如果菜单已经显示，直接让第一个Item获取焦点
                    requestMenuFocus();
                }
                event.consume(); // 消费事件，避免TextField处理向下键
            }
        });

        // 菜单显示后自动设置焦点到第一个Item
        suggestionMenu.showingProperty().addListener((obs, wasShowing, isNowShowing) -> {
            if (isNowShowing && !suggestionMenu.getItems().isEmpty()) {
                Platform.runLater(this::requestMenuFocus);
            }
        });

        // 给菜单添加事件过滤器，处理向上键和空格键
        suggestionMenu.addEventFilter(KeyEvent.KEY_PRESSED, event -> {
            if (event.getCode() == KeyCode.UP) {
                // 检查当前焦点是否在第一个MenuItem
                CustomMenuItem firstItem = (CustomMenuItem) suggestionMenu.getItems().get(0);
                if (firstItem.isFocused()) {
                    suggestionMenu.hide();
                    requestFocus(); // 把焦点还给TextField
                    event.consume();
                }
            } else if (event.getCode() == KeyCode.SPACE) {
                // 消费空格键事件，不触发onAction
                event.consume();
            }
        });
    }

    // 辅助方法：让第一个MenuItem获取焦点
    private void requestMenuFocus() {
        if (!suggestionMenu.getItems().isEmpty()) {
            CustomMenuItem firstItem = (CustomMenuItem) suggestionMenu.getItems().get(0);
            firstItem.requestFocus();
        }
    }
}

关键改进点说明 #

• 焦点设置可靠性：用Platform.runLater延迟设置焦点，确保ContextMenu的UI已经初始化完成，直接操作菜单的Item对象而非通过lookup查找节点，避免了节点未就绪的问题。
• 事件消费：在TextField的向下键监听中消费事件，避免TextField默认处理向下键（比如光标移动）；在菜单的事件过滤器中消费向上键（当在第一项时）和空格键，实现自定义逻辑。
• 焦点切换：当在第一项按向上键时，不仅隐藏菜单，还把焦点还给TextField，保证交互的连贯性。

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