.NET MAUI桌面应用MVVM Toolkit Popup键盘导航焦点问题求助

核心思路 #

Windows平台下，MAUI弹窗默认不会自动夺取焦点，需要手动处理弹窗的焦点捕获和Tab循环范围限制，确保焦点锁定在弹窗内部。

具体解决方案 #

1. 自定义Popup控件，重写OnAppearing处理焦点 #

创建自定义Popup类，在弹窗显示时主动捕获焦点，并限制Tab导航仅在弹窗内部循环：

using CommunityToolkit.Maui.Views;
using Microsoft.Maui.Controls.PlatformConfiguration.WindowsSpecific;
using Microsoft.UI.Xaml;
using Microsoft.UI.Xaml.Controls;

public class FocusablePopup : Popup
{
    protected override void OnAppearing()
    {
        base.OnAppearing();

        if (DeviceInfo.Platform == DevicePlatform.Windows)
        {
            var nativePopup = this.Handler?.NativeView as Microsoft.UI.Xaml.Controls.Primitives.Popup;
            if (nativePopup != null && nativePopup.Child is FrameworkElement childElement)
            {
                // 设置弹窗为Tab循环容器，限制导航范围
                childElement.IsTabStop = false;
                childElement.TabNavigation = KeyboardNavigationMode.Cycle;

                // 延迟设置焦点，避免UI未完全加载导致失效
                Dispatcher.DispatchDelayed(TimeSpan.FromMilliseconds(100), () =>
                {
                    var firstFocusable = FindFirstFocusableElement(childElement);
                    firstFocusable?.Focus(FocusState.Programmatic);
                });

                // 全局监听Enter键，触发当前聚焦按钮的点击事件
                childElement.KeyDown += (s, e) =>
                {
                    if (e.Key == Windows.System.VirtualKey.Enter)
                    {
                        var focusedBtn = FocusManager.GetFocusedElement() as Button;
                        focusedBtn?.RaiseEvent(new RoutedEventArgs(Button.ClickEvent));
                        e.Handled = true;
                    }
                };
            }
        }
    }

    // 递归查找第一个可聚焦的控件
    private FrameworkElement? FindFirstFocusableElement(FrameworkElement parent)
    {
        foreach (var child in parent.ChildrenOfType<FrameworkElement>())
        {
            if (child.IsTabStop && child.IsEnabled)
            {
                return child;
            }

            var nestedChild = FindFirstFocusableElement(child);
            if (nestedChild != null)
            {
                return nestedChild;
            }
        }
        return null;
    }
}

2. XAML中使用自定义Popup替换默认控件 #

将原有的<mct:Popup>替换为自定义的<local:FocusablePopup>，弹窗内的按钮保持默认配置即可（Button默认IsTabStop="True"）：

<local:FocusablePopup x:Name="NotificationPopup">
    <VerticalStackLayout Padding="20" WidthRequest="300">
        <Label Text="确认执行此操作？" Margin="0,0,0,20"/>
        <HorizontalStackLayout HorizontalOptions="End">
            <Button x:Name="CancelBtn" Text="Cancel" Clicked="CancelBtn_Clicked"/>
            <Button x:Name="OkBtn" Text="OK" Clicked="OkBtn_Clicked" Margin="10,0,0,0"/>
        </HorizontalStackLayout>
    </VerticalStackLayout>
</local:FocusablePopup>

关键注意事项 #

• 延迟设置焦点：弹窗刚显示时UI可能未完全渲染，直接调用焦点设置会失效，Dispatcher.DispatchDelayed能确保控件加载完成后再操作。
• 限制Tab循环：通过TabNavigation = KeyboardNavigationMode.Cycle让Tab键仅在弹窗内部循环，不会跳回主窗口控件。
• 平台针对性处理：仅在Windows平台执行上述逻辑，其他平台（如Android/iOS）的Popup焦点机制无需额外干预。

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