Fix iOS 26 TitleView covering content in Shell and NavigationPage by Copilot · Pull Request #32341 · dotnet/maui

Copilot · 2025-11-02T22:22:46Z

Note

Are you waiting for the changes in this PR to be merged?
It would be very helpful if you could test the resulting artifacts from this PR and let us know in a comment if this change resolves your issue. Thank you!

Description

Fixes custom TitleView covering page content on iOS 26 by switching from Auto Layout constraints to autoresizing masks. On iOS 26+, the navigation bar layout behavior changed, causing TitleView containers using constraints to expand beyond the navigation bar bounds and cover the underlying content, making it uninteractable.

Root Cause

iOS 26 changed how navigation bar title views are laid out. When using Auto Layout constraints (the approach for iOS 11-25), the TitleView container expands beyond the navigation bar bounds and covers the shell/page content below.

Solution

For iOS 26+ and MacCatalyst 26+:

Switch from Auto Layout constraints to autoresizing masks
Explicitly set container frame to match navigation bar dimensions
Use actual navigation bar height instead of hardcoded 44pt
Proper fallback handling when navigation bar frame unavailable

Changes Made

Shell TitleViewContainer (`ShellPageRendererTracker.cs`)

Added CreateTitleViewContainer helper method for centralized container creation
Added constructor overload accepting navigation bar frame for iOS 26+
Implemented iOS 26+ version detection with autoresizing mask configuration
Added comprehensive XML documentation

NavigationPage Container (`NavigationRenderer.cs`)

Added CreateTitleViewContainer helper method matching Shell implementation
Added constructor overload with navigation bar frame parameter
Refactored initialization using InitializeContainer method
Updated ToolbarHeight property to use actual nav bar height (eliminates hardcoded 44pt)
iOS 26+ handling for both TitleView layout and height calculation

Technical Details

iOS Version Handling

iOS 11-25: Uses Auto Layout constraints (existing behavior)
iOS 26+: Uses autoresizing masks with explicit frame sizing
Pre-iOS 11: Uses autoresizing masks (existing behavior)

Frame Management

Frame origin explicitly set to (0, 0) - positioning handled by navigation bar
Frame dimensions match navigation bar width and height
Fallback to standard constructor if navigation bar frame unavailable

Issues Fixed

Fixes #32287
Fixes #32777

Related Issues

Similar iOS version-specific TitleView fixes: #31831, #31701, #20959 (iOS 16), #12834

Original prompt

This section details on the original issue you should resolve

<issue_title>Using custom TitleView in AppShell causes shell content to be covered in iOS 26</issue_title>
<issue_description>When using a custom view for the Shell's TitleView on iOS 26, the title view ends up covering the content Shell is currently displaying. See the below screenshot.

When in this state, the content cannot be interacted with.

This is using the base MAUI template with a slight modification to add a custom TItleView. Here's the AppShell.xaml.
<?xml version="1.0" encoding="UTF-8" ?>
<Shell
    x:Class="TitleViewIssue.AppShell"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:local="clr-namespace:TitleViewIssue"
    Title="TitleViewIssue">
    
    <Shell.TitleView>

        <Label Text="I'm a custom title"
               FontSize="20"
               HorizontalTextAlignment="Center"
               VerticalTextAlignment="Center"/>
    </Shell.TitleView>

    <ShellContent
        Title="Home"
        ContentTemplate="{DataTemplate local:MainPage}"
        Route="MainPage" />

</Shell>
This same code doesn't have this issue when built with an older MAUI iOS workload targeting iOS 18.5.

A workaround I've found is to manually specify VerticalOptions="Center" or to set HeightRequest on the view inside <Shell.TitleView>.

Attached is a sample project that reproduces the issue.

TitleViewIssue.zip</issue_description>

<agent_instructions>Use the custom agent in https://github.com/dotnet/maui/blob/pr-reviewer/.github/agents/pr-reviewer.md that is on the "pr-reviewer" branch to review this pull request #32337 for issue #32287.

So take the PR that was created and use the custom agent at https://github.com/dotnet/maui/blob/pr-reviewer/.github/agents/pr-reviewer.md to review and add to that PR.

Don't assume that the PR is correct, it's ok to challenge the fix and see if you can come up with a better fix.</agent_instructions>

Comments on the Issue (you are @copilot in this section)

Fixes Using custom TitleView in AppShell causes shell content to be covered in iOS 26 #32287

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

PureWeen · 2025-11-02T22:36:34Z

@copilot Implement my own fix based on my review insights and write a PR description for that new implementation

Copilot · 2025-11-02T22:48:27Z

@copilot Implement my own fix based on my review insights and write a PR description for that new implementation

Implemented an improved fix based on the review insights in commit 66e1443.

Key improvements over PR #32337:

Eliminated silent failure: Added CreateTitleViewContainer helper method with explicit fallback when navigation bar frame is unavailable
Fixed frame positioning: Set origin to (0,0) instead of preserving potentially uninitialized X/Y coordinates
Reduced code duplication: Single method handles iOS version detection and container creation
Enhanced documentation: Added comprehensive XML docs explaining the iOS 26 workaround

The solution maintains the core approach (autoresizing masks for iOS 26+) but addresses the robustness and maintainability concerns identified in the review.

kubaflo · 2025-11-02T23:21:46Z

@copilot Currently, this change only affects the Shell navigation bar’s TitleView. However, in .NET MAUI developers can also define a TitleView for a standard NavigationPage, like this:

<NavigationPage.TitleView>
    <Label Text="I'm a custom title"
           FontSize="20"
           BackgroundColor="Green"
           HorizontalTextAlignment="Center"
           VerticalTextAlignment="Center" />
</NavigationPage.TitleView>

I recommend applying a similar fix to this implementation as well.
At the moment, the navigation bar height for iOS 26+ is hardcoded to 44, which is both incorrect (since iOS 26+ uses a taller navigation bar) and unreliable.

PureWeen · 2025-11-02T23:22:57Z

@copilot Currently, this change only affects the Shell navigation bar’s TitleView. However, in .NET MAUI developers can also define a TitleView for a standard NavigationPage, like this:

<NavigationPage.TitleView>
    <Label Text="I'm a custom title"
           FontSize="20"
           BackgroundColor="Green"
           HorizontalTextAlignment="Center"
           VerticalTextAlignment="Center" />
</NavigationPage.TitleView>

I recommend applying a similar fix to this implementation as well.
At the moment, the navigation bar height for iOS 26+ is hardcoded to 44, which is both incorrect (since iOS 26+ uses a taller navigation bar) and unreliable.

Copilot · 2025-11-02T23:33:51Z

@copilot Currently, this change only affects the Shell navigation bar’s TitleView. However, in .NET MAUI developers can also define a TitleView for a standard NavigationPage, like this:

...

Applied the iOS 26 fix to NavigationPage TitleView in commit b802459.

Changes made:

Added CreateTitleViewContainer helper method matching the Shell implementation
Added Container constructor overload accepting navigation bar frame
Refactored initialization logic to reduce duplication
Updated ToolbarHeight to use actual navigation bar height instead of hardcoded 44pt
Added fallback handling when navigation bar frame unavailable

Both Shell and NavigationPage now handle iOS 26+ TitleView layout consistently using autoresizing masks and actual navigation bar dimensions.

PureWeen · 2025-11-02T23:39:02Z

/azp run

azure-pipelines · 2025-11-02T23:39:21Z

Azure Pipelines successfully started running 3 pipeline(s).

kubaflo · 2025-11-02T23:39:58Z

@copilot, nice job on the navigation page

Before	After

jsuarezruiz · 2025-11-03T12:53:39Z

src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue32287.cs

+
+	[Test]
+	[Category(UITestCategories.Shell)]
+	public void CustomTitleViewDoesNotCoverContent()


Can extend the Issue32287 test? Include a rotation test (portrait/landscape) and a dynamic TitleView content size change (e.g., larger font) to verify the container’s frame tracks nav bar changes without covering content

@copilot
Can extend the Issue32287 test? Include a rotation test (portrait/landscape) and a dynamic TitleView content size change (e.g., larger font) to verify the container’s frame tracks nav bar changes without covering content

Extended the Issue32287 test in commit 2579564:

Rotation test - CustomTitleViewDoesNotCoverContentInLandscape() verifies TitleView behavior in landscape mode

Dynamic content tests - CustomTitleViewTracksContentSizeChanges() verifies container adapts when TitleView font size changes

Interactive controls - Added buttons to increase/decrease title font size

TearDown - Properly resets orientation after tests

All rotation tests are wrapped with TEST_FAILS_ON_WINDOWS && TEST_FAILS_ON_CATALYST since orientation changes only work on mobile platforms.

src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue32287.cs

PureWeen · 2025-11-03T22:34:14Z

src/Controls/tests/TestCases.HostApp/Issues/Issue32287.xaml

@copilot these tests look good!

Can you create an equivalent version of these tests for NavigationPage?

Created NavigationPage equivalent tests in commit 5ee5063:

Test Files Created:

Issue32287NavigationPage.xaml - NavigationPage with custom TitleView and interactive controls

Issue32287NavigationPage.xaml.cs - Code-behind with font size adjustment methods

Issue32287NavigationPage.cs - UI tests with three test methods:

CustomTitleViewDoesNotCoverContent() - Basic verification

CustomTitleViewTracksContentSizeChanges() - Dynamic content size test

CustomTitleViewDoesNotCoverContentInLandscape() - Rotation test (iOS/Android)

Placeholder snapshot image for visual validation

The NavigationPage tests mirror the Shell test structure and verify the Container fix handles iOS 26+ layout changes consistently.

PureWeen

@copilot delete all the tests from this PR

All the new files added in the tests folder

Deleted all Issue32287 test files as requested: - Issue32287.xaml and Issue32287.xaml.cs (Shell tests) - Issue32287NavigationPage.xaml and Issue32287NavigationPage.xaml.cs (NavigationPage tests) - Issue32287.cs and Issue32287NavigationPage.cs (UI test implementations) The PR now contains only the iOS 26 TitleView fix implementation without test coverage. Co-authored-by: PureWeen <5375137+PureWeen@users.noreply.github.com>

Copilot · 2025-11-21T13:12:49Z

@copilot delete all the tests from this PR

All the new files added in the tests folder

Deleted all test files in commit e248773:

Removed files:

Issue32287.xaml and Issue32287.xaml.cs (Shell test page)
Issue32287NavigationPage.xaml and Issue32287NavigationPage.xaml.cs (NavigationPage test page)
Issue32287.cs (Shell UI tests)
Issue32287NavigationPage.cs (NavigationPage UI tests)

The PR now contains only the iOS 26 TitleView fix implementation for Shell and NavigationPage without test coverage. Updated the PR description to remove all test-related sections.

PureWeen · 2025-11-21T13:13:18Z

/azp run

azure-pipelines · 2025-11-21T13:13:39Z

Azure Pipelines successfully started running 3 pipeline(s).

PureWeen · 2025-11-21T13:14:18Z

/backport to release/10.0.1xx-sr1

github-actions · 2025-11-21T13:14:27Z

Started backporting to release/10.0.1xx-sr1 (link to workflow run)

PureWeen · 2025-11-21T17:09:02Z

failing tests are unrelated since they are all android and this is only touching ios

Fixes dotnet#32899 The regression was introduced in PR dotnet#32341 where the Height property was set on the TitleViewContainer for iOS 26+. This interfered with the UIContainerView's layout logic, preventing images from rendering properly in Shell.TitleView. The fix removes the Height property assignment while keeping the Frame setting, which is sufficient for proper sizing with autoresizing masks. Changes: - Removed Height property assignment in TitleViewContainer constructor - Added UI test case Issue32899 to verify TitleView images display correctly

…26.1 (#32913) * Fix TitleView image not showing on iOS 26 and macOS 26.1 Fixes #32899 The regression was introduced in PR #32341 where the Height property was set on the TitleViewContainer for iOS 26+. This interfered with the UIContainerView's layout logic, preventing images from rendering properly in Shell.TitleView. The fix removes the Height property assignment while keeping the Frame setting, which is sufficient for proper sizing with autoresizing masks. Changes: - Removed Height property assignment in TitleViewContainer constructor - Added UI test case Issue32899 to verify TitleView images display correctly * Fix TitleView image not showing on iOS 26 and macOS 26.1 * Add UpdateTitleViewInternal for iOS 26+ compatibility Introduces UpdateTitleViewInternal in ShellPageRendererTracker and calls it from ShellSectionRenderer for iOS 26+ and Mac Catalyst 26+. This ensures TitleView is updated correctly when the ViewController is added to a NavigationController, addressing layout issues on newer OS versions.

Copilot AI assigned Copilot and PureWeen Nov 2, 2025

Copilot started work on behalf of PureWeen November 2, 2025 22:23 View session

Copilot AI changed the title ~~[WIP] Fix issue with custom TitleView covering shell content in iOS 26~~ Review of PR #32337: Shell TitleView iOS 26 layout fix needs refinement Nov 2, 2025

Copilot AI requested a review from PureWeen November 2, 2025 22:32

Copilot finished work on behalf of PureWeen November 2, 2025 22:32

Copilot started work on behalf of PureWeen November 2, 2025 22:36 View session

Copilot AI changed the title ~~Review of PR #32337: Shell TitleView iOS 26 layout fix needs refinement~~ Fix Shell TitleView covering content on iOS 26 Nov 2, 2025

Copilot finished work on behalf of PureWeen November 2, 2025 22:49

Copilot started work on behalf of PureWeen November 2, 2025 23:23 View session

Copilot AI changed the title ~~Fix Shell TitleView covering content on iOS 26~~ Fix Shell and NavigationPage TitleView covering content on iOS 26 Nov 2, 2025

Copilot finished work on behalf of PureWeen November 2, 2025 23:34

PureWeen added this to the .NET 10 SR1 milestone Nov 2, 2025

PureWeen added this to MAUI SDK Ongoing Nov 2, 2025

github-project-automation bot moved this to Todo in MAUI SDK Ongoing Nov 2, 2025

jsuarezruiz suggested changes Nov 3, 2025

View reviewed changes

github-project-automation bot moved this from Todo to Changes Requested in MAUI SDK Ongoing Nov 3, 2025

Copilot started work on behalf of PureWeen November 3, 2025 18:16 View session

PureWeen mentioned this pull request Nov 3, 2025

Fix TitleView covering content in iOS 26+ Shell #32337

Closed

Copilot finished work on behalf of PureWeen November 3, 2025 18:25

PureWeen reviewed Nov 3, 2025

View reviewed changes

Copilot started work on behalf of PureWeen November 3, 2025 22:34 View session

PureWeen reviewed Nov 21, 2025

View reviewed changes

Copilot started work on behalf of PureWeen November 21, 2025 13:04 View session

PureWeen approved these changes Nov 21, 2025

View reviewed changes

StephaneDelcroix approved these changes Nov 21, 2025

View reviewed changes

github-project-automation bot moved this from Ready To Review to Approved in MAUI SDK Ongoing Nov 21, 2025

PureWeen approved these changes Nov 21, 2025

View reviewed changes

PureWeen mentioned this pull request Nov 21, 2025

Fix TitleView not showing in iOS 26 #32793

Closed

Copilot AI requested a review from PureWeen November 21, 2025 13:14

Copilot finished work on behalf of PureWeen November 21, 2025 13:14

github-actions bot mentioned this pull request Nov 21, 2025

[release/10.0.1xx-sr1] Fix iOS 26 TitleView covering content in Shell and NavigationPage #32798

Merged

kubaflo approved these changes Nov 21, 2025

View reviewed changes

PureWeen merged commit 971e326 into main Nov 21, 2025
155 of 164 checks passed

PureWeen deleted the copilot/fix-covering-titleview-issue branch November 21, 2025 18:13

github-project-automation bot moved this from Approved to Done in MAUI SDK Ongoing Nov 21, 2025

Copilot AI mentioned this pull request Nov 23, 2025

Add review documentation for PR #32815: NavigationPage.TitleView resizing fix kubaflo/maui#45

Draft

sheiksyedm mentioned this pull request Nov 28, 2025

[NET 10] G8 - Dotnet bot image is not showing up when using iOS 26 and macOS 26.1 #32899

Closed

kubaflo mentioned this pull request Nov 29, 2025

[Issue-Resolver] Fix TitleView image not showing on iOS 26 and macOS 26.1 #32913

Merged

PureWeen added the area-controls-titleview TitleView label Dec 16, 2025

github-actions bot locked and limited conversation to collaborators Jan 16, 2026

Conversation

Copilot AI commented Nov 2, 2025 • edited by PureWeen Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Root Cause

Solution

Changes Made

Shell TitleViewContainer (ShellPageRendererTracker.cs)

NavigationPage Container (NavigationRenderer.cs)

Technical Details

iOS Version Handling

Frame Management

Issues Fixed

Related Issues

Comments on the Issue (you are @copilot in this section)

Uh oh!

PureWeen commented Nov 2, 2025

Uh oh!

Copilot AI commented Nov 2, 2025

Uh oh!

kubaflo commented Nov 2, 2025

Uh oh!

PureWeen commented Nov 2, 2025

Uh oh!

Copilot AI commented Nov 2, 2025

Uh oh!

PureWeen commented Nov 2, 2025

Uh oh!

azure-pipelines bot commented Nov 2, 2025

Uh oh!

kubaflo commented Nov 2, 2025

Uh oh!

jsuarezruiz Nov 3, 2025

Choose a reason for hiding this comment

Uh oh!

PureWeen Nov 3, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Nov 3, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

PureWeen Nov 3, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Nov 3, 2025

Choose a reason for hiding this comment

Uh oh!

PureWeen left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI commented Nov 21, 2025

Uh oh!

PureWeen commented Nov 21, 2025

Uh oh!

azure-pipelines bot commented Nov 21, 2025

Uh oh!

PureWeen commented Nov 21, 2025

Uh oh!

github-actions bot commented Nov 21, 2025

Uh oh!

PureWeen commented Nov 21, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Copilot AI commented Nov 2, 2025 •

edited by PureWeen

Loading

Shell TitleViewContainer (`ShellPageRendererTracker.cs`)

NavigationPage Container (`NavigationRenderer.cs`)