JavaFX TextField自定义光标：始终可见、蓝色加粗（JavaFX17）

针对JavaFX 17.0.2版本，要实现光标始终可见（无论是否聚焦）、蓝色、加粗的效果，这里提供两种可行方案：

方案一：自定义TextField叠加光标节点（推荐，无内部API依赖） #

通过在TextField上叠加一个自定义的Line节点模拟光标，完全自主控制其显示状态和样式，稳定性更高。

代码实现 #

import javafx.animation.KeyFrame;
import javafx.animation.Timeline;
import javafx.beans.value.ChangeListener;
import javafx.geometry.Bounds;
import javafx.scene.control.TextField;
import javafx.scene.shape.Line;
import javafx.util.Duration;

public class CustomTextField extends TextField {
    private final Line customCaret;
    private final Timeline blinkTimeline;

    public CustomTextField() {
        // 初始化自定义光标：蓝色、2px宽度（模拟加粗）
        customCaret = new Line();
        customCaret.setStroke(javafx.scene.paint.Color.BLUE);
        customCaret.setStrokeWidth(2);
        customCaret.setVisible(true);

        // 可选：添加光标闪烁动画，和系统光标行为一致
        blinkTimeline = new Timeline(
                new KeyFrame(Duration.millis(500), e -> customCaret.setVisible(!customCaret.isVisible())),
                new KeyFrame(Duration.millis(1000), e -> customCaret.setVisible(!customCaret.isVisible()))
        );
        blinkTimeline.setCycleCount(Timeline.INDEFINITE);
        blinkTimeline.play();

        // 将光标节点加入TextField的子节点
        getChildren().add(customCaret);

        // 监听光标位置、文本内容、组件尺寸变化，实时更新光标位置
        ChangeListener<? super Integer> caretListener = (obs, oldVal, newVal) -> updateCaretPos();
        caretPositionProperty().addListener(caretListener);
        textProperty().addListener((obs, oldText, newText) -> updateCaretPos());
        widthProperty().addListener((obs, oldW, newW) -> updateCaretPos());
        heightProperty().addListener((obs, oldH, newH) -> updateCaretPos());

        // 强制光标始终可见，不受焦点状态影响
        focusedProperty().addListener((obs, oldFocus, newFocus) -> customCaret.setVisible(true));
    }

    private void updateCaretPos() {
        Bounds caretBounds = getCaretBounds(getCaretPosition());
        if (caretBounds != null) {
            customCaret.setStartX(caretBounds.getMinX());
            customCaret.setStartY(caretBounds.getMinY());
            customCaret.setEndX(caretBounds.getMinX());
            customCaret.setEndY(caretBounds.getMaxY());
        }
    }

    @Override
    protected void layoutChildren() {
        super.layoutChildren();
        updateCaretPos();
    }
}

使用说明 #

• 直接实例化CustomTextField即可，无需额外配置
• 如果不需要光标闪烁，删除blinkTimeline相关代码即可

方案二：通过反射修改TextFieldSkin内部Caret（依赖内部API） #

JavaFX 17的TextFieldSkin内部有一个包私有Caret类，可通过反射获取并修改其属性，实现需求。但该方案依赖JavaFX内部实现，版本升级可能失效。

代码实现 #

import javafx.scene.control.Skin;
import javafx.scene.control.TextField;
import com.sun.javafx.scene.control.skin.TextFieldSkin;
import java.lang.reflect.Field;

public class AlwaysVisibleCaretTextField extends TextField {
    @Override
    protected Skin<?> createDefaultSkin() {
        return new AlwaysVisibleCaretSkin(this);
    }

    private static class AlwaysVisibleCaretSkin extends TextFieldSkin {
        public AlwaysVisibleCaretSkin(TextField textField) {
            super(textField);
            try {
                // 反射获取内部Caret实例
                Field caretField = TextFieldSkin.class.getDeclaredField("caret");
                caretField.setAccessible(true);
                Object caret = caretField.get(this);

                // 设置光标颜色为蓝色
                Field colorField = caret.getClass().getDeclaredField("caretColor");
                colorField.setAccessible(true);
                colorField.set(caret, javafx.scene.paint.Color.BLUE);

                // 设置光标宽度为2px（模拟加粗）
                Field widthField = caret.getClass().getDeclaredField("caretWidth");
                widthField.setAccessible(true);
                widthField.setInt(caret, 2);

                // 强制光标始终可见，覆盖默认的焦点控制逻辑
                Field visibleField = caret.getClass().getDeclaredField("visible");
                visibleField.setAccessible(true);
                visibleField.setBoolean(caret, true);

                // 监听焦点变化，保持光标可见
                textField.focusedProperty().addListener((obs, oldVal, newVal) -> {
                    try {
                        visibleField.setBoolean(caret, true);
                    } catch (Exception e) {
                        e.printStackTrace();
                    }
                });

            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

关于CSS无效的说明 #

你尝试的-fx-caret-color: blue;未生效，大概率是因为默认TextField仅在聚焦时显示光标，即使颜色设置正确，失去焦点后光标会隐藏。结合上述方案让光标始终可见后，CSS样式即可生效，比如给自定义TextField添加样式类：

.custom-text-field {
    -fx-caret-color: blue;
}

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