Unity UI Toolkit按钮如何添加键盘与控制器支持？求可行方案

不用切换回旧UGUI按钮系统，UI Toolkit完全能搞定键盘和控制器输入，问题大多出在配置不到位上。以下是具体解决步骤：

1. 先搞定基础依赖 #

确保项目装了Input System包（Package Manager里搜索即可安装），UI Toolkit和新Input System适配更好；如果坚持用旧Input Manager也可以，但优先推荐新系统。

2. 让按钮能被选中 #

UI Builder创建的按钮默认带Clickable组件，但要接收键盘/控制器输入，得确保：

• 在UI Builder的Inspector面板里，把按钮的Focusable选项勾选上（或者直接在UXML代码里写focusable="true"）。
• 复杂UI场景下，根容器也要确保允许焦点传递，一般默认配置没问题，若焦点无响应可检查根元素的Focusable属性。

3. 两种实现路径 #

路径一：用原生导航与焦点（推荐，零代码） #

• 在UI Builder中选中目标按钮，到Inspector的Navigation模块，配置上下左右的导航目标（比如绑定相邻按钮），用户就能通过方向键/摇杆在按钮间切换焦点。
• 按钮获得焦点后，键盘按Enter/Space，控制器按对应平台的确认键（如Xbox的A键、PS的X键），会自动触发按钮点击——完全无需额外代码，Clickable组件会原生处理该逻辑。

路径二：代码自定义输入触发 #

如果需要更灵活的控制（比如特定按键直接触发、无视焦点状态），可以通过代码绑定输入事件：

using UnityEngine;
using UnityEngine.UIElements;

public class UIBButtonInputHandler : MonoBehaviour
{
    private Button _targetButton;

    void Awake()
    {
        var uiDoc = GetComponent<UIDocument>();
        // 替换为你在UI Builder中给按钮设置的名称
        _targetButton = uiDoc.rootVisualElement.Q<Button>("MenuConfirmBtn");
    }

    void Update()
    {
        // 监听Submit输入（可在Input System中自定义按键绑定）
        if (Input.GetButtonDown("Submit"))
        {
            // 可选：仅当按钮处于聚焦状态时触发
            if (_targetButton.focused)
            {
                _targetButton.clickable.click.Invoke();
            }
            // 或直接触发，无视焦点状态
            // _targetButton.clickable.click.Invoke();
        }
    }
}

将脚本挂载在带有UI Document组件的GameObject上，替换按钮名称后即可生效。

4. 常见问题排查 #

• 按钮无法获取焦点：检查是否有其他UI元素（如全屏面板）设置了Focusable且抢占了焦点；或确认UI Document对应的面板处于激活状态。
• 输入无响应：在Input System的Input Actions中确认"Submit"绑定了正确的按键/控制器按钮；若使用旧Input Manager，检查Edit > Project Settings > Input中的Submit轴配置。

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