MAUI Shell导航：如何实现详情页返回对应源页面并保留参数传递？

一、PushAsync是否支持IQueryAttributable？ #

不支持。PushAsync属于传统导航栈方法，而IQueryAttributable是MAUI Shell路由导航专属的参数传递接口，仅在Shell通过路由解析跳转时才会触发ApplyQueryAttributes方法，传统PushAsync不会调用该接口，因此无法用这种方式传递参数。

二、核心解决方案：用Shell的GoToAsync实现Push新实例+保留参数传递 #

调整GoToAsync的使用方式，确保跳转时将ItemDetailsPage作为新实例Push到当前导航栈，而非导航到Shell层级中已存在的页面，这样源页面会留在栈内，返回时即可回到跳转前的页面，同时保留IQueryAttributable传参模式。

具体步骤： #

1. 确保路由注册正确
   在AppShell.xaml中注册ItemDetailsPage的路由，默认页面为Transient（每次跳转创建新实例），无需额外设置Singleton：

   <ShellContent Route="ItemDetailsPage" ContentTemplate="{DataTemplate local:ItemDetailsPage}" />
   

2. 使用相对路由跳转
   从任意源页面跳转时，使用相对路由调用GoToAsync，并通过字典传递参数：

   // 源页面中跳转的代码
   var parameters = new Dictionary<string, object>
   {
       { "ItemId", selectedItem.Id },
       { "ItemName", selectedItem.Name }
   };
   await Shell.Current.GoToAsync("ItemDetailsPage", parameters);
   

   这里的"ItemDetailsPage"是相对路由，Shell会自动创建新的ItemDetailsPage实例并Push到当前导航栈顶部，此时导航栈结构为源页面 -> ItemDetailsPage。

3. ItemDetailsPage接收参数
   保持IQueryAttributable的实现不变，正常解析参数：

   public partial class ItemDetailsPage : ContentPage, IQueryAttributable
   {
       public void ApplyQueryAttributes(IDictionary<string, object> query)
       {
           if (query.TryGetValue("ItemId", out var itemIdObj) && int.TryParse(itemIdObj.ToString(), out var itemId))
           {
               // 处理ItemId参数
           }
           if (query.TryGetValue("ItemName", out var itemName))
           {
               // 处理ItemName参数
           }
       }
   
       // OK按钮点击事件
       private async void OnOkClicked(object sender, EventArgs e)
       {
           await Shell.Current.Navigation.PopAsync();
       }
   }
   

关键注意事项： #

• 避免使用绝对路由（如//MainPage/ItemDetailsPage），这种写法会导航到Shell层级中对应的页面，可能弹出当前栈中的源页面，导致返回时回到父页面而非源页面。
• 如果需要从嵌套的Shell层级跳转，相对路由可以用../ItemDetailsPage来向上一级再跳转，确保始终基于当前导航栈Push新实例。

三、备选方案：强制指定导航模式（如果相对路由不生效） #

如果上述方法因路由结构特殊不生效，可以通过ShellNavigationQueryParameters指定NavigationMode.New，强制创建新实例并Push到栈顶：

var queryParams = new ShellNavigationQueryParameters
{
    { "ItemId", selectedItem.Id }
};
queryParams.NavigationMode = NavigationMode.New;
await Shell.Current.GoToAsync("ItemDetailsPage", queryParams);

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