SuperAPI AI 工具集

maui-shell-navigation

通用与其它

查看项目

更新于 10-15 20:34

技能介绍

用途:为 .NET MAUI 应用提供 Shell 导航的实践指导,涵盖 Shell 视觉层级、AppShell 设置、标签栏、浮出菜单、基于 URI 的 GoToAsync 导航与路由注册。

主要能力:建议 ShellContent 使用 ContentTemplate 与 DataTemplate,使页面按需创建而非在 Shell 初始化时全部创建,以改善启动时间;传参优先用 IQueryAttributable 而非 QueryProperty,便于在 ViewModel 中一次获取全部参数;复杂对象可用 ShellNavigationQueryParameters 避免序列化;导航拦截可用 GetDeferral() 的异步延迟模式处理未保存更改确认。

用法要点:相对路由必须先经 Routing.RegisterRoute 注册才能 GoToAsync;视觉层级页面使用绝对 // 路由。路由名必须全应用唯一,重复注册会抛 ArgumentException。GoToAsync 为异步,必须 await,否则易出现竞态或静默失败。绝对路由需匹配完整视觉层级路径(如 //FlyoutItem/Tab/ShellContent),路径错误会导致静默无操作而非异常。Tab.Stack 只读,无法直接操作导航栈。使用 ContentTemplate 时页面构造函数仅在首次导航时执行。

适用场景:构建 .NET MAUI 跨平台应用的导航结构、标签与浮出菜单、参数传递与导航守卫。

限制:价格、平台支持范围与具体安装方式暂未提供。