From a6421ad0b8c4b57a2b814e0ca432fe23662e8505 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 28 Nov 2025 22:28:05 +0000 Subject: [PATCH 1/3] Initial plan From 1464910b86defb63cb20a52340477b79912a6a55 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 28 Nov 2025 22:32:16 +0000 Subject: [PATCH 2/3] Clarify TabbedPage Shell incompatibility with specific navigation scenarios Co-authored-by: PureWeen <5375137+PureWeen@users.noreply.github.com> --- docs/user-interface/pages/tabbedpage.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/user-interface/pages/tabbedpage.md b/docs/user-interface/pages/tabbedpage.md index f06f81840..1af9be839 100644 --- a/docs/user-interface/pages/tabbedpage.md +++ b/docs/user-interface/pages/tabbedpage.md @@ -1,7 +1,7 @@ --- title: "TabbedPage" description: "The .NET MAUI TabbedPage consists of a series of pages that are navigable by tabs across the top or bottom of the page, with each tab loading the page content." -ms.date: 09/30/2024 +ms.date: 11/28/2025 --- # TabbedPage @@ -25,7 +25,7 @@ The title of a tab is defined by the , each object is created when the is constructed. This can lead to a poor user experience, particularly if the is the root page of your app. However, .NET MAUI Shell enables pages accessed through a tab bar to be created on demand, in response to navigation. For more information about Shell apps, see [Shell](~/fundamentals/shell/index.md). > [!WARNING] -> is incompatible with .NET MAUI Shell apps, and an exception will be thrown if you attempt to use in a Shell app. +> is incompatible with .NET MAUI Shell apps, and an exception will be thrown if you attempt to use in a Shell app. This includes registering a as a route with `Routing.RegisterRoute` and navigating to it with `Shell.Current.GoToAsync`. If you need tab-based navigation in a Shell app, use Shell tabs instead. For more information, see [Shell tabs](~/fundamentals/shell/tabs.md). ## Create a TabbedPage From 896349d4e84a152685cd81b745d879f7741e4416 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 15 Dec 2025 02:55:36 +0000 Subject: [PATCH 3/3] Clarify that TabbedPage can be used as a modal in Shell apps Co-authored-by: PureWeen <5375137+PureWeen@users.noreply.github.com> --- docs/user-interface/pages/tabbedpage.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/user-interface/pages/tabbedpage.md b/docs/user-interface/pages/tabbedpage.md index 1af9be839..8af2edf32 100644 --- a/docs/user-interface/pages/tabbedpage.md +++ b/docs/user-interface/pages/tabbedpage.md @@ -25,7 +25,7 @@ The title of a tab is defined by the , each object is created when the is constructed. This can lead to a poor user experience, particularly if the is the root page of your app. However, .NET MAUI Shell enables pages accessed through a tab bar to be created on demand, in response to navigation. For more information about Shell apps, see [Shell](~/fundamentals/shell/index.md). > [!WARNING] -> is incompatible with .NET MAUI Shell apps, and an exception will be thrown if you attempt to use in a Shell app. This includes registering a as a route with `Routing.RegisterRoute` and navigating to it with `Shell.Current.GoToAsync`. If you need tab-based navigation in a Shell app, use Shell tabs instead. For more information, see [Shell tabs](~/fundamentals/shell/tabs.md). +> is incompatible with the .NET MAUI Shell visual hierarchy, and an exception will be thrown if you attempt to add to the Shell visual hierarchy. This includes registering a as a route with `Routing.RegisterRoute` and navigating to it with `Shell.Current.GoToAsync`. However, it's valid to display a as a modal page in a Shell app by using `Navigation.PushModalAsync`, because modal pages exist in a separate navigation space. If you need tab-based navigation as part of the Shell visual hierarchy, use Shell tabs instead. For more information, see [Shell tabs](~/fundamentals/shell/tabs.md) and [Perform modal navigation](~/user-interface/pages/navigationpage.md#perform-modal-navigation). ## Create a TabbedPage