MAUI怎么在Shell导航中隐藏某个页面 MAUI路由配置

.NET MAUI Shell中“隐藏页面”指不显示在Flyout或TabBar中但可通过URI导航,需仅注册路由而不放入可视化容器;可动态设IsVisible控制显隐,并用Navigating事件拦截非法跳转。

在 .NET MAUI Shell 导航中,**“隐藏某个页面”通常指不让该页面出现在抽屉菜单(Flyout)或标签栏(TabBar)中,但依然能通过 URI 导航跳转过去**——比如详情页、编辑页、登录后跳转页等非主入口页面。这不是真正“禁用”,而是**路由可见性控制**,靠 Shell 的路由注册方式和 UI 结构配置实现。

只注册路由,不放入 FlyoutItem 或 TabBar

Shell 页面是否显示在导航 UI 中,取决于它是否被包含在 FlyoutItemTabBarTab 这些可视化容器里。只要不把页面放进这些结构,它就不会出现在菜单或底部标签中,但仍可通过 GoToAsync 访问。

  • ✅ 正确做法:在 AppShell.xaml 中只给需要展示的页面配 ShellContent,其他页面仅注册路由
  • ❌ 错误做法:把所有页面都塞进 FlyoutItem,再用代码隐藏(无效且破坏结构)

示例:只让 cats/dogs 出现在菜单,monkeys 页面可跳转但不显示


  
    
      
      
    

  

  

然后在 AppShell.xaml.cs 中注册路由:

Routing.RegisterRoute("monkeys", typeof(MonkeysPage));

用 ShellContent 设置 IsVisible="False"

如果某页面已放在 FlyoutItemTab 中,但想临时隐藏(比如权限控制),可以用 IsVisible 属性动态控制其可见性。

  • IsVisible="False" 会让该项从 Flyout 或 TabBar 中完全消失(不只是变灰)
  • 需在代码中绑定或设置,XAML 中写死不灵活,推荐运行时控制

例如在 AppShell.xaml.cs 构造函数或 OnNavigated 中:

var monkeysItem = this.FlyoutItems.OfType()
  .FirstOrDefault(f => f.Route == "monkeys");
if (monkeysItem != null)
  monkeysItem.IsVisible = User.HasPermission("view-monkeys");

避免被路由匹配到的“伪隐藏”技巧

有些页面你希望彻底屏蔽外部访问(比如未登录时禁止跳转),光靠 UI 隐藏不够,还需拦截导航:

  • 订阅 Shell.Navigating 事件,在跳转前判断目标路由和当前状态
  • 调用 e.Cancel = true 可中断导航,并可跳转到登录页
  • 适合做权限校验,不是 UI 隐藏,但常配合使用

示例:

Shell.Current.Navigating += (s, e) =>
{
  if (e.Target.Location.ToString().Contains("admin") && !User.IsAdmin)
  {
    e.Cancel = true;
    await Shell.Current.GoToAsync("//login");
  }
};

基本上就这些。关键记住:Shell 中页面“显隐”本质是结构决定的——放进 Flyout/Tab 就可见,只注册路由就不占 UI 位置。配合 IsVisibleNavigating 事件,就能做到精准控制。