JavaFX Popup在其他应用获焦后无法重新获取焦点的解决方法

问题描述 #

用JavaFX Popup做收货地址编辑时，从浏览器复制内容返回应用后，点击Popup内的TextField无法输入或粘贴，必须先点击后方的主Stage才能正常交互。鼠标事件能触发，但键盘输入被其他应用接收，控件也没有焦点高亮。

核心原因 #

Popup依赖主Stage存在，当应用失去系统焦点后，直接点击Popup只能触发JavaFX的鼠标事件，但操作系统层面的焦点仍留在其他应用，导致键盘输入无法传递到Popup控件——单纯调用requestFocus()解决不了系统焦点未切换的问题。

解决方案 #

在Popup的根节点上监听鼠标按下事件，先让主Stage向操作系统请求焦点，再延迟让目标控件获取内部焦点：

import javafx.application.Application;
import javafx.application.Platform;
import javafx.geometry.Insets;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.control.TextField;
import javafx.scene.layout.VBox;
import javafx.stage.Popup;
import javafx.stage.Stage;

public class HelloApplication extends Application {
    @Override
    public void start(Stage stage) {
        VBox parentVBox = new VBox();
        Scene scene = new Scene(parentVBox, 600, 600);
        stage.setTitle("Hello!");
        stage.setScene(scene);
        stage.show();

        Popup popup = new Popup();
        Button btn = new Button("This is a very nice button!");
        btn.setOnAction(actionEvent -> System.out.println("button clicked"));

        TextField textField = new TextField();
        textField.setOnMouseClicked(mouseEvent -> System.out.println("textField clicked"));

        VBox popupVBox = new VBox(btn, textField);
        popupVBox.setStyle("-fx-background-color: white");
        popupVBox.setPadding(new Insets(10));

        // 解决焦点问题的关键逻辑
        popupVBox.setOnMousePressed(event -> {
            // 先让主Stage获取系统层面的焦点
            stage.requestFocus();
            // 延迟执行控件焦点请求，确保系统焦点切换完成
            Platform.runLater(() -> {
                if (event.getTarget() instanceof TextField) {
                    textField.requestFocus();
                } else if (event.getTarget() instanceof Button) {
                    btn.requestFocus();
                }
            });
        });

        popup.getContent().add(popupVBox);
        popup.show(stage);
    }

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

原理说明 #

1. stage.requestFocus()：主动向操作系统申请将焦点切换回主应用，这是让键盘输入能传递到应用内部的前提。
2. Platform.runLater(...)：延迟执行控件焦点请求，避免因为系统焦点切换的时序问题导致内部焦点请求失效。

补充说明 #

• 若Popup内有更多控件，可以优化判断逻辑，直接将焦点请求到事件的目标控件，不用逐个判断。
• 避免仅调用控件的requestFocus()，因为此时系统焦点不在当前应用，该调用无法生效。

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