Swing嵌入JavaFX面板日语输入预测弹窗显示异常问题咨询

我之前在做Swing与JavaFX混合开发时，也碰到过一模一样的日语输入法适配问题——输入时会出现带"ENTER"标识的额外文本框，而且预测弹窗位置完全偏离输入框。这种问题本质是两个UI toolkit的输入法桥接机制冲突导致的，尤其是在嵌入式场景下，下面分享几个亲测有效的解决思路：

问题复现场景 #

用户提供的复现代码如下（已补全必要导入）：

import javafx.application.Platform;
import javafx.geometry.Pos;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.control.Label;
import javafx.scene.control.TextField;
import javafx.scene.layout.GridPane;
import javafx.embed.swing.JFXPanel;
import javax.swing.*;
import org.jetbrains.annotations.NotNull;

public class SwingEmbedJavaFXExample extends JDialog {
    public static void main(String[] args) {
        new SwingEmbedJavaFXExample().setJFX();
    }
    private void setJFX() {
        JFXPanel jfxPanel = new JFXPanel();
        GridPane grid = createGridWithJavaFXLabelTextFieldAndAButton();
        getContentPane().add(jfxPanel);
        // initialize FX with JFXPanel which has scene get by gridPane
        //embedding jfxPanel to JDialog
        Platform.runLater(() -> initFX(jfxPanel, grid));
        this.setVisible(true);
    }
    private void initFX(JFXPanel jfxPanel, GridPane grid) {
        Scene scene = new Scene(grid, 300, 275);
        jfxPanel.setScene(scene);
    }
    @NotNull
    private GridPane createGridWithJavaFXLabelTextFieldAndAButton() {
        GridPane grid = new GridPane();
        grid.setAlignment(Pos.CENTER);
        Label label = new Label("Label: ");
        grid.add(label, 0, 1);
        TextField textField = new TextField();
        textField.setId("PropertyNameTextfield");
        textField.setPromptText("promptText");
        grid.add(textField, 1, 1);
        grid.add(new Button("Hit me!"), 2, 1);
        return grid;
    }
}

问题表现为：日语输入时出现额外的带"ENTER"的文本框，预测候选弹窗位置偏离UI组件。

可行的解决方案 #

1. 修正线程初始化顺序，避免线程冲突

Swing的EDT线程和JavaFX的Application Thread必须严格分离，且JavaFX平台要提前初始化，避免后续嵌入式场景的线程混乱：

public static void main(String[] args) {
    // 提前初始化JavaFX平台，确保FX环境就绪
    Platform.startup(() -> {});
    // 在Swing的EDT线程中创建并显示对话框
    SwingUtilities.invokeLater(() -> new SwingEmbedJavaFXExample().setJFX());
}

这种方式能让两个UI框架的初始化流程完全隔离，减少输入法桥接的冲突概率。

2. 调整输入法系统属性，强制使用"即时输入"模式

通过设置系统属性，让输入法采用on-the-spot模式，确保候选弹窗直接绑定到JavaFX输入框：

public static void main(String[] args) {
    // 强制输入法使用即时显示模式
    System.setProperty("java.awt.im.style", "on-the-spot");
    Platform.startup(() -> {});
    SwingUtilities.invokeLater(() -> new SwingEmbedJavaFXExample().setJFX());
}

这个属性会告诉AWT输入法框架不要弹出独立的候选框，而是直接在输入组件附近显示，避免Swing和JavaFX的候选框同时出现。

3. 确保JFXPanel和输入组件正确获取焦点

焦点问题是输入法弹窗错位的常见原因，需要明确让JFXPanel和TextField获得焦点：

private void setJFX() {
    JFXPanel jfxPanel = new JFXPanel();
    GridPane grid = createGridWithJavaFXLabelTextFieldAndAButton();
    getContentPane().add(jfxPanel);
    
    Platform.runLater(() -> {
        initFX(jfxPanel, grid);
        // 确保JFXPanel获取焦点
        jfxPanel.requestFocus();
        // 让TextField自动获得输入焦点
        grid.getChildren().stream()
            .filter(node -> node instanceof TextField)
            .map(node -> (TextField) node)
            .findFirst()
            .ifPresent(TextField::requestFocus);
    });
    
    this.setVisible(true);
}

当输入组件正确获取焦点时，输入法的上下文会正确绑定到JavaFX组件，而不是Swing容器上。

问题根源 #

Swing和JavaFX各自维护一套输入法处理逻辑，当JFXPanel嵌入到Swing容器时，系统输入法框架可能同时触发Swing的输入适配（导致出现带"ENTER"的额外候选框）和JavaFX的输入适配，再加上两个框架的窗口层级不同，最终导致候选弹窗错位。

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