如何为JavaFX TextField添加焦点事件以清除初始文本？

你的代码没生效的核心原因是：你把焦点监听器的添加逻辑放在了onAction绑定的方法里，而onAction事件只有在用户按下回车键提交TextField内容时才会触发。这意味着在TextField第一次获得焦点时，这个监听器根本还没被添加到控件上，自然不会执行清空操作。

下面给你几种可行的解决方案，从简单到自定义实现：

方案1：使用原生的promptText属性（推荐） #

JavaFX的TextField自带了占位符文本功能，完全不需要自己写监听器。只需要把FXML里的text属性换成promptText：

<TextField fx:id="passwordShown" promptText="Password" GridPane.columnIndex="1" GridPane.rowIndex="2"/>

这样效果是：当TextField为空时，会显示灰色的"Password"提示文本；一旦获得焦点并输入内容，提示文本自动消失；如果清空内容并失去焦点，提示文本又会重新显示。这是最简洁且符合原生UI规范的做法。

方案2：在控制器初始化时添加焦点监听器 #

如果你一定要用自定义的初始文本逻辑，可以在控制器初始化阶段就给TextField的焦点属性添加监听器。首先让控制器实现Initializable接口，然后在initialize方法里绑定逻辑：

import javafx.fxml.Initializable;
import javafx.scene.control.TextField;
import java.net.URL;
import java.util.ResourceBundle;

public class YourController implements Initializable {
    @FXML
    private TextField passwordShown;

    @Override
    public void initialize(URL url, ResourceBundle resourceBundle) {
        // 监听焦点变化
        passwordShown.focusedProperty().addListener((observable, oldFocusState, newFocusState) -> {
            // 获得焦点时，如果文本是初始值则清空
            if (newFocusState && passwordShown.getText().equals("Password")) {
                passwordShown.setText("");
            }
            // 可选：失去焦点时，如果文本为空则恢复初始值
            if (!newFocusState && passwordShown.getText().isEmpty()) {
                passwordShown.setText("Password");
            }
        });
    }
}

对应的FXML不需要绑定onAction，保持基础配置即可：

<TextField fx:id="passwordShown" text="Password" GridPane.columnIndex="1" GridPane.rowIndex="2"/>

方案3：直接绑定onFocusGained事件 #

你也可以直接在FXML中绑定TextField的onFocusGained事件，触发清空方法：

控制器代码 #

import javafx.scene.control.TextField;

public class YourController {
    @FXML
    private TextField passwordShown;

    // 获得焦点时触发
    @FXML
    protected void onPasswordFieldFocusGained() {
        if (passwordShown.getText().equals("Password")) {
            passwordShown.setText("");
        }
    }

    // 可选：失去焦点时恢复初始文本
    @FXML
    protected void onPasswordFieldFocusLost() {
        if (passwordShown.getText().isEmpty()) {
            passwordShown.setText("Password");
        }
    }
}

FXML代码 #

<TextField fx:id="passwordShown" text="Password" GridPane.columnIndex="1" GridPane.rowIndex="2"
           onFocusGained="#onPasswordFieldFocusGained"
           onFocusLost="#onPasswordFieldFocusLost"/>

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