如何为Java JTextField添加示例提示文本？

你需要区分提示文本和用户实际输入的内容，只在搜索栏显示默认提示且获得焦点时才清空，已经输入内容的情况下点击保留原有文本。推荐使用FocusListener替代MouseListener，因为它能处理所有焦点切换场景（比如Tab键切换），逻辑更严谨：

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

public class SearchTextField extends JTextField {
    private static final String PLACEHOLDER = "Search...";
    private static final Color PLACEHOLDER_COLOR = Color.GRAY;
    private static final Color TEXT_COLOR = Color.BLACK;

    public SearchTextField() {
        super(PLACEHOLDER);
        setForeground(PLACEHOLDER_COLOR);
        
        addFocusListener(new FocusListener() {
            @Override
            public void focusGained(FocusEvent e) {
                // 只有当前是提示文本时，才清空并切换颜色
                if (getText().equals(PLACEHOLDER)) {
                    setText("");
                    setForeground(TEXT_COLOR);
                }
            }

            @Override
            public void focusLost(FocusEvent e) {
                // 失去焦点且文本为空时，恢复提示文本和灰色
                if (getText().isEmpty()) {
                    setText(PLACEHOLDER);
                    setForeground(PLACEHOLDER_COLOR);
                }
            }
        });
    }

    // 重写getText方法，避免获取到提示文本（可选，根据业务需求）
    @Override
    public String getText() {
        String text = super.getText();
        return text.equals(PLACEHOLDER) ? "" : text;
    }
}

使用方式 #

直接创建这个自定义类的实例即可：

JTextField searchBar = new SearchTextField();

关键逻辑说明 #

• 初始化时设置提示文本和灰色字体
• 获得焦点时：仅当当前内容是提示文本，才清空并切换为黑色字体；如果是用户输入的内容，保持不变
• 失去焦点时：如果文本为空，恢复提示文本和灰色字体，确保框架重绘后依然显示提示
• 重写getText()方法（可选）：当需要获取用户输入内容时，自动过滤掉提示文本，避免业务逻辑出错

这样就能实现你要的效果：框架重绘时显示灰色提示，激活后保留用户输入的内容，不会每次点击都清空。

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