Unity中如何阻止UI Toolkit点击事件穿透到底层GameObject？

以下是几个直接可行的解决方法，适配你模态对话框+底部按钮的场景：

1. 给全屏根面板添加事件拦截 #

UI Toolkit的VisualElement默认不会主动阻断事件向下传递，给覆盖全屏的根Panel添加事件拦截，就能彻底阻止点击事件传到底层：

• 在UI Builder中选中根VisualElement，在样式面板添加pointer-events: all;（确保面板能接收所有指针事件）
• 在C#代码中给根元素注册指针按下事件，拦截事件传播：

var root = GetComponent<UIDocument>().rootVisualElement;
root.RegisterCallback<PointerDownEvent>(evt =>
{
    evt.PreventDefault(); // 阻止事件默认行为
    evt.StopPropagation(); // 停止事件向底层传递
});

不管点击UI空白区域还是按钮，事件都不会漏到底层GameObject。

2. 使用ModalUtility实现模态对话框 #

如果核心需求是做模态对话框，直接用UI Toolkit内置的ModalUtility，它会自动处理背景交互拦截：

// 假设你的对话框元素是dialogElement
ModalUtility.ShowModal(dialogElement, () =>
{
    // 对话框关闭后的回调逻辑
});

这个方法会自动将对话框设为模态，点击对话框外的区域不会触发任何底层操作，完美匹配你的需求。

3. 在3D对象的射线检测中排除UI交互 #

如果底层GameObject是通过Physics.Raycast处理点击，修改射线检测逻辑，先判断是否点击在UI Toolkit元素上：

if (Input.GetMouseButtonDown(0))
{
    var uiDoc = FindObjectOfType<UIDocument>();
    Vector2 localPos = uiDoc.rootVisualElement.WorldToLocal(new Vector2(Input.mousePosition.x, Input.mousePosition.y));
    // 检查鼠标位置是否在UI元素范围内
    if (uiDoc.rootVisualElement.ContainsPoint(localPos))
    {
        return; // 点击在UI上，跳过3D对象处理
    }

    // 原来的3D射线检测逻辑
    int worldLayer = LayerMask.NameToLayer("World");
    int layerMask = 1 << worldLayer;
    if (Physics.Raycast(Camera.main.ScreenPointToRay(Input.mousePosition), out RaycastHit hit, Mathf.Infinity, layerMask))
    {
        // 处理3D对象点击
    }
}

同时确保射线检测只针对World层，避免误触UI层（UIDocument默认是屏幕空间，不会被3D射线命中，但保险起见）。

4. 检查EventSystem的设置 #

确保场景中只有一个EventSystem，并且UI Toolkit的UIDocument和3D对象的交互逻辑无冲突。如果同时使用UGUI和UI Toolkit，需注意两者事件优先级，单UI Toolkit场景只需保证EventSystem正常运行即可。

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