JavaFX如何保持Canvas默认焦点以支持地图快捷键平移操作

方案3可行性与隐藏问题 #

方案3是完全可行的，但是存在几个容易忽略的隐藏问题：

• 需要排除的可输入组件不只是TextField、TextArea，还要覆盖PasswordField、ComboBox编辑器、Spinner编辑器等所有支持文本输入/方向键操作的组件，否则会出现用户在这类组件内操作方向键时同步触发地图平移的冲突
• 如果应用包含子窗口/弹窗，仅给主Scene绑定事件过滤器无法捕获子窗口的按键事件，需要给所有子窗口的Scene同步绑定同一个过滤器
• 需要注意事件消费逻辑：如果当前焦点在可输入组件上，不要消费事件，保证输入组件的正常交互；如果焦点不在可输入组件上，消费事件后再执行地图平移逻辑，避免事件向下传递触发其他组件的意外行为

更简单的遗漏方案 #

你还可以选择下面两个无侵入的自动方案，不需要对现有组件做任何修改，后续新增组件也不用额外加兼容代码：

方案A：全局焦点监听自动归还焦点 #

给Scene注册焦点所有者变化监听器，当焦点从可输入组件转移到非输入组件时，自动将焦点切回Canvas：

scene.focusOwnerProperty().addListener((obs, oldFocus, newFocus) -> {
    boolean oldIsInput = isInputComponent(oldFocus);
    boolean newIsInput = isInputComponent(newFocus);
    // 当用户结束输入，焦点离开输入组件时，自动把焦点切回Canvas
    if (oldIsInput && !newIsInput) {
        canvas.requestFocus();
    }
});

// 辅助方法：递归判断组件是否属于可输入类型
private boolean isInputComponent(Node node) {
    if (node == null) return false;
    if (node instanceof TextInputControl || node instanceof ComboBoxBase) {
        return true;
    }
    if (node instanceof Parent) {
        for (Node child : ((Parent) node).getChildrenUnmodifiable()) {
            if (isInputComponent(child)) {
                return true;
            }
        }
    }
    return false;
}

方案B（最优推荐）：全局按键过滤，不依赖Canvas焦点 #

直接将地图平移的按键逻辑从Canvas的按键监听器迁移到Scene的全局事件过滤器，完全不需要依赖Canvas的焦点状态，从根源上解决焦点丢失的问题：

scene.addEventFilter(KeyEvent.KEY_PRESSED, e -> {
    // 当前焦点在输入组件上时直接跳过，不处理地图平移
    if (isInputComponent(scene.getFocusOwner())) {
        return;
    }
    KeyCode code = e.getCode();
    // 处理地图平移逻辑
    if (code == KeyCode.W || code == KeyCode.UP) {
        // 地图上移逻辑
        e.consume();
    } else if (code == KeyCode.S || code == KeyCode.DOWN) {
        // 地图下移逻辑
        e.consume();
    } else if (code == KeyCode.A || code == KeyCode.LEFT) {
        // 地图左移逻辑
        e.consume();
    } else if (code == KeyCode.D || code == KeyCode.RIGHT) {
        // 地图右移逻辑
        e.consume();
    }
});

// 同上的isInputComponent辅助方法
private boolean isInputComponent(Node node) {
    if (node == null) return false;
    if (node instanceof TextInputControl || node instanceof ComboBoxBase) {
        return true;
    }
    if (node instanceof Parent) {
        for (Node child : ((Parent) node).getChildrenUnmodifiable()) {
            if (isInputComponent(child)) {
                return true;
            }
        }
    }
    return false;
}

这个方案的优势非常明显：

• 完全不需要操作焦点，即使用户操作后焦点落在普通按钮、面板等组件上，按对应按键也能直接控制地图，不需要等待焦点切回Canvas
• 逻辑一次编写全局生效，后续新增任何UI组件都不需要修改兼容代码，100%稳定
• 天然规避输入组件内操作方向键和地图平移的冲突问题

方案选择建议 #

优先选择方案B，是所有方案里适配成本最低、可靠性最高的方案，完全满足你的需求。

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