You need to enable JavaScript to run this app. 通过代码跳转Shell页面时如何保留左上角Shell菜单按钮
优惠活动
大模型
产品
解决方案
定价
更多

通过代码跳转Shell页面时如何保留左上角Shell菜单按钮

Shell框架代码跳转后菜单按钮丢失的解决方案

问题根因

这个现象是Shell的默认交互逻辑导致的:

  • 从侧边菜单项导航跳转时,目标页面是直接和ShellFlyoutItem绑定的根级页面,左上角默认展示汉堡菜单按钮
  • 使用await Shell.Current.GoToAsync("step")这种相对路由跳转时,step页面会被压入当前所在页面的导航栈,成为二级子页面。此时Shell会自动把左上角的菜单按钮替换成返回箭头,就出现了菜单按钮消失的现象。

具体修复方式

1. 使用绝对路由直接定位到目标Flyout页面

如果你的step页面本身是注册在ShellFlyoutItem下的侧边菜单对应页,直接把原跳转代码改成根级绝对路由即可:

// 原跳转代码
// await Shell.Current.GoToAsync("step");

// 修改后正常显示菜单的跳转代码
await Shell.Current.GoToAsync("//step");

//前缀的作用是清空当前导航栈,直接跳转到Shell根节点下匹配的路由页面,此时Shell会识别该页面属于侧边菜单关联的页面,自动显示汉堡菜单按钮,不会替换成返回按钮。

2. 核对路由的注册归属

如果你的step页面是通过全局注册的方式添加的路由,没有绑定到任何ShellFlyoutItem下,无论怎么跳转都不会正常显示菜单按钮:

  • 正确的注册方式是把step页对应的ShellContent节点放到Shell.FlyoutItems的ShellFlyoutItem内部,示例结构:
<Shell>
    <Shell.FlyoutItems>
        <ShellFlyoutItem Title="步骤页" Icon="step_icon.png">
            <ShellContent Route="step" ContentTemplate="{DataTemplate local:StepPage}" />
        </ShellFlyoutItem>
    </Shell.FlyoutItems>
</Shell>
  • 不要用Routing.RegisterRoute("step", typeof(StepPage))把作为菜单项的页面注册成全局普通路由,这类路由对应的页面默认是作为二级push页面存在的,不会关联侧边菜单。

3. 特殊场景强制显示菜单按钮

如果你的step页面确实是需要压入导航栈的二级页面,但依然要保留左上角的菜单按钮,可以在StepPage的代码后台手动覆盖Shell的默认显示逻辑:

protected override void OnAppearing()
{
    base.OnAppearing();
    // 强制开启页面的Flyout菜单展示
    Shell.SetFlyoutItemIsVisible(this, true);
}

注意:这种方式会打破Shell默认的返回交互逻辑,仅适合特殊业务场景使用,常规场景不推荐。


内容的提问来源于stack exchange,提问作者Stauron

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.10 19:36:07