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

在 .NET MAUI Shell 导航中,**“隐藏某个页面”通常指不让该页面出现在抽屉菜单(Flyout)或标签栏(TabBar)中,但依然能通过 URI 导航跳转过去**——比如详情页、编辑页、登录后跳转页等非主入口页面。这不是真正“禁用”,而是**路由可见性控制**,靠 Shell 的路由注册方式和 UI 结构配置实现。
只注册路由,不放入 FlyoutItem 或 TabBar
Shell 页面是否显示在导航 UI 中,取决于它是否被包含在 FlyoutItem、TabBar 或 Tab 这些可视化容器里。只要不把页面放进这些结构,它就不会出现在菜单或底部标签中,但仍可通过 GoToAsync 访问。
- ✅ 正确做法:在
AppShell.xaml中只给需要展示的页面配ShellContent,其他页面仅注册路由 - ❌ 错误做法:把所有页面都塞进
FlyoutItem,再用代码隐藏(无效且破坏结构)
示例:只让 cats/dogs 出现在菜单,monkeys 页面可跳转但不显示
然后在 AppShell.xaml.cs 中注册路由:
用 ShellContent 设置 IsVisible="False"
如果某页面已放在 FlyoutItem 或 Tab 中,但想临时隐藏(比如权限控制),可以用 IsVisible 属性动态控制其可见性。
-
IsVisible="False"会让该项从 Flyout 或 TabBar 中完全消失(不只是变灰) - 需在代码中绑定或设置,XAML 中写死不灵活,推荐运行时控制
例如在 AppShell.xaml.cs 构造函数或 OnNavigated 中:
.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 位置。配合 IsVisible 和 Navigating 事件,就能做到精准控制。











