JavaFX TextArea的selectRange()为何有时无法高亮选中内容？

我使用OpenJDK 19搭配JavaFX 19编写了一段代码，通过上下键导航TextArea中的行，每次按键触发时都会调用selectRange()方法设置选中范围。但实际操作中，只有顶部和底部位置的行需要用户按两次键才会显示选中高亮，而getSelectedText()方法却能正常获取到选中文本。想咨询这是JavaFX库的bug还是我的代码存在问题？

代码示例 #

package jfxTest;

import java.util.Random;

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.TextArea;
import javafx.scene.input.KeyCode;
import javafx.scene.input.KeyEvent;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;

public class Main extends Application {
    public static void main(String[] args) {
        Application.launch(args);
    }

    private static int selectionIndex = 0;
    private static TextArea textArea;

    @Override
    public void start(Stage primaryStage) {
        System.out.println("Starting JavaFX Window...");
        StackPane rootPane = new StackPane();
        textArea = new TextArea();

        textArea.setText("TEST");
        textArea.setEditable(false);
        createRandomOptions(8);

        textArea.addEventFilter(KeyEvent.KEY_PRESSED, event -> {
            if (event.getCode().equals(KeyCode.UP)) {
                select(selectionIndex <= 0 ? 0 : selectionIndex - 1);
            }
            if (event.getCode().equals(KeyCode.DOWN)) {
                String[] lines = textArea.getText().split("\n");
                select(selectionIndex >= lines.length - 1 ? lines.length - 1 : selectionIndex + 1);
            }
        });

        rootPane.getChildren().add(textArea);
        Scene scene = new Scene(rootPane, 900, 500);
        primaryStage.setScene(scene);
        primaryStage.show();
        System.out.println("Created window.");
        System.out.println("\nNow press up and down keys to navigate:\n"
                + "Notice, that although a new selection is displayed in the console, it is not\n"
                + "highlighted in the window itself. Even a call to getSelectedText() works fine.\n");
    }
    
    /**
     * Creates a bunch of random options in textArea.
     * @param newOptionCount
     */
    private static void createRandomOptions(int newOptionCount) {
        for (int i = 0; i < newOptionCount; i++) {
            textArea.appendText("\nSEL" + (new Random().nextInt(10000)));
        }
    }
    
    private static void select(int newSelectionIndex) {
        String[] lines = textArea.getText().split("\n");
        
        System.out.println("New selection index: " + newSelectionIndex);
        selectionIndex = newSelectionIndex;
        
        // Determine selection indexes
        int selectionStart = 0;
        int selectionEnd = 0;
        for (int i = 0; i < newSelectionIndex; i++) {
            selectionStart += lines[i].length() + 1;
        }
        selectionEnd = selectionStart + lines[newSelectionIndex].length();
        
        // Does not work. Selection does need to be applied twice by the user to be actually highlighted.
        textArea.selectRange(selectionStart, selectionEnd);
        
        System.out.println("Selected text: " + textArea.getSelectedText() + "\n");
    }
}

问题原因 #

这不是JavaFX的bug，而是代码逻辑的问题：你使用了**事件过滤器（EventFilter）**处理按键事件，事件过滤器会在事件到达目标节点（TextArea）之前触发。当你在过滤器中调用selectRange()设置选中范围后，TextArea自带的上下键处理逻辑（比如移动光标）会紧接着执行，直接覆盖了你设置的选中状态。

只有当导航到顶部或底部时，TextArea自带的处理逻辑没有可移动的空间，不会修改光标/选中状态，你的设置才会生效——这就是为什么需要按两次键：第一次你的设置被自带逻辑覆盖，第二次自带逻辑不执行，选中状态才会保留。

解决方法 #

有两种可行的修复方式：

方式1：改用事件处理器（EventHandler） #

将addEventFilter替换为addEventHandler，这样你的代码会在TextArea自带的事件处理完成后执行，不会被覆盖：

textArea.addEventHandler(KeyEvent.KEY_PRESSED, event -> {
    if (event.getCode().equals(KeyCode.UP)) {
        select(selectionIndex <= 0 ? 0 : selectionIndex - 1);
    }
    if (event.getCode().equals(KeyCode.DOWN)) {
        String[] lines = textArea.getText().split("\n");
        select(selectionIndex >= lines.length - 1 ? lines.length - 1 : selectionIndex + 1);
    }
});

方式2：在事件过滤器中消费事件 #

处理完事件后调用event.consume()，阻止事件继续传递给TextArea的自带处理逻辑，避免你的选中状态被覆盖：

textArea.addEventFilter(KeyEvent.KEY_PRESSED, event -> {
    if (event.getCode().equals(KeyCode.UP)) {
        select(selectionIndex <= 0 ? 0 : selectionIndex - 1);
        event.consume();
    }
    if (event.getCode().equals(KeyCode.DOWN)) {
        String[] lines = textArea.getText().split("\n");
        select(selectionIndex >= lines.length - 1 ? lines.length - 1 : selectionIndex + 1);
        event.consume();
    }
});

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