Java Swing如何实现带临时占位提示文本的文本输入框？

当然可以实现这种效果，核心思路是给JTextField添加监听逻辑，维护提示文本的显示与隐藏状态，以下是具体实现方案：

自定义带提示的JTextField #

通过继承JTextField并添加监听器，实现提示文本自动消失/恢复的逻辑：

import javax.swing.*;
import java.awt.*;
import java.awt.event.FocusAdapter;
import java.awt.event.FocusEvent;

public class HintTextField extends JTextField {
    private final String hint;
    private final Color hintColor = Color.GRAY;
    private final Color textColor;

    public HintTextField(String hintText) {
        this.hint = hintText;
        this.textColor = getForeground();
        
        // 初始化显示提示文本
        setText(hint);
        setForeground(hintColor);

        // 焦点监听：获取焦点时清空提示，失去焦点且为空时恢复提示
        addFocusListener(new FocusAdapter() {
            @Override
            public void focusGained(FocusEvent e) {
                if (getText().equals(hint)) {
                    setText("");
                    setForeground(textColor);
                }
            }

            @Override
            public void focusLost(FocusEvent e) {
                if (getText().isEmpty()) {
                    setText(hint);
                    setForeground(hintColor);
                }
            }
        });

        // 文档监听：输入第一个字符时自动替换提示文本
        getDocument().addDocumentListener(new javax.swing.event.DocumentListener() {
            @Override
            public void insertUpdate(javax.swing.event.DocumentEvent e) {
                if (getText().equals(hint)) {
                    setText("");
                    setForeground(textColor);
                }
            }

            @Override
            public void removeUpdate(javax.swing.event.DocumentEvent e) {
                if (getText().isEmpty()) {
                    setText(hint);
                    setForeground(hintColor);
                }
            }

            @Override
            public void changedUpdate(javax.swing.event.DocumentEvent e) {}
        });
    }

    // 重写getText，确保返回用户实际输入内容而非提示文本
    @Override
    public String getText() {
        String currentText = super.getText();
        return currentText.equals(hint) ? "" : currentText;
    }
}

使用示例 #

在你的Swing界面中直接使用这个自定义组件：

public class DemoFrame {
    public static void main(String[] args) {
        JFrame frame = new JFrame("提示文本输入框演示");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(350, 120);
        frame.setLayout(new FlowLayout(FlowLayout.CENTER, 20, 30));

        HintTextField inputField = new HintTextField("enter the text");
        inputField.setPreferredSize(new Dimension(280, 35));
        frame.add(inputField);

        frame.setVisible(true);
    }
}

实现说明 #

• 提示文本默认使用灰色，与用户输入的文本颜色区分开
• 两种触发提示消失的场景：获取输入框焦点、输入第一个字符
• 当输入框为空且失去焦点时，会自动恢复提示文本
• 重写getText()方法，避免获取到提示文本内容，保证业务逻辑中拿到的是用户实际输入

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