Java Swing自定义FocusListener引发JTextField焦点异常问题求助

问题根源 #

1. Swing默认会把初始焦点分配给容器内第一个可聚焦组件，导致启动时第一个JTextField自动触发focusGained事件，不符合预期。
2. 自定义监听器的focusLost方法没有区分临时焦点事件（比如切换到其他应用、点击窗口空白区），只要文本为空就恢复提示文本，而当没有其他可聚焦组件时，Swing会强制把焦点拉回原组件，造成无法取消焦点的死循环。
3. 原代码类名与系统接口FocusListener重名，属于不良编码习惯，可能引发潜在冲突。

修复方案 #

1. 修改监听器逻辑，处理临时焦点事件 #

在focusLost中先判断事件是否为临时事件，跳过不必要的文本修改；同时优化空文本判断，避免空格干扰；另外重命名监听器类避免冲突。

2. 取消初始自动聚焦 #

窗口初始化完成后，将焦点转移到容器（如JPanel），让所有文本框启动时都处于非聚焦状态。

修改后的完整代码 #

自定义焦点监听器 #

import java.awt.Color;
import java.awt.event.FocusEvent;
import java.awt.event.FocusListener;
import javax.swing.JTextField;

// 重命名类名，避免和系统接口重名
public class CustomFocusListener implements FocusListener
{
    private final JTextField textField;
    private final String placeholderText;

    public CustomFocusListener(JTextField textField, String placeholderText)
    {
        this.textField = textField;
        this.placeholderText = placeholderText;
        // 初始化时直接设置提示文本和灰色前景
        textField.setForeground(Color.GRAY);
        textField.setText(placeholderText);
    }

    @Override
    public void focusGained(FocusEvent e) {
        // 只有当前文本是提示文本时才清空
        if (placeholderText.equals(textField.getText())) {
            textField.setText("");
            textField.setForeground(Color.BLACK);
        }
    }

    @Override
    public void focusLost(FocusEvent e) {
        // 忽略临时焦点转移（比如切应用、点窗口空白）
        if (e.isTemporary()) {
            return;
        }
        // 文本为空（含空格）时恢复提示文本
        if (textField.getText().trim().isEmpty()) {
            textField.setForeground(Color.GRAY);
            textField.setText(placeholderText);
        }
    }
}

窗口使用示例 #

import javax.swing.BorderFactory;
import javax.swing.JFrame;
import javax.swing.JPanel;
import javax.swing.JTextField;
import javax.swing.SwingUtilities;
import java.awt.GridLayout;

public class MainFrame extends JFrame {
    public MainFrame() {
        JPanel panel = new JPanel(new GridLayout(2, 1, 5, 5));
        panel.setBorder(BorderFactory.createEmptyBorder(10, 10, 10, 10));
        // 让面板可以接收焦点
        panel.setFocusable(true);

        JTextField field1 = new JTextField(20);
        JTextField field2 = new JTextField(20);

        field1.addFocusListener(new CustomFocusListener(field1, "输入用户名"));
        field2.addFocusListener(new CustomFocusListener(field2, "输入密码"));

        panel.add(field1);
        panel.add(field2);
        add(panel);

        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        pack();
        setLocationRelativeTo(null);
        
        // 将初始焦点设置到面板，避免文本框自动聚焦
        panel.requestFocusInWindow();
    }

    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> new MainFrame().setVisible(true));
    }
}

关键修改点说明 #

• 监听器类重命名为CustomFocusListener，避免与系统接口冲突。
• 构造方法中初始化提示文本，确保组件启动状态正确。
• focusLost中加入e.isTemporary()判断，解决临时焦点转移时的异常问题。
• 使用trim()判断空文本，避免用户输入空格导致提示文本不恢复。
• 设置JPanel可聚焦并请求初始焦点，解决启动时文本框自动聚焦的问题。

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