[Mac] Fix Titlebar content is not aligned to left on fullscreen

[devanathan-vaithiyanathan]

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!

Issue details

in mac when the app enters in full screen mode, titlebar content is not aligned to the left.

Description of Change

Added logic to adjust the TitleBar content margin based on full-screen state (Mac Catalyst 16+). When in full-screen, left margin is removed; otherwise, a margin of 80 is applied to align with traffic light spacing.

Issues Fixed

Fixes #30248

Tested the behavior in the following platforms.

• Android
• Windows
• iOS
• Mac

Before	After
Mac Before.mov	Mac After.mov

[dotnet-policy-service]

Hey there @@devanathan-vaithiyanathan! Thank you so much for your PR! Someone from the team will get assigned to your PR shortly and we'll get it reviewed.

[jsuarezruiz]

/azp run MAUI-UITests-public

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).

[jsuarezruiz]

/azp run MAUI-UITests-public

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).

[kubaflo]

Could you please resolve conflicts?

[github-actions]

🚀 Dogfood this PR with:

⚠️ WARNING: Do not do this without first carefully reviewing the code of this PR to satisfy yourself it is safe.

curl -fsSL https://raw.githubusercontent.com/dotnet/maui/main/eng/scripts/get-maui-pr.sh | bash -s -- 30378

Or

• Run remotely in PowerShell:

iex "& { $(irm https://raw.githubusercontent.com/dotnet/maui/main/eng/scripts/get-maui-pr.ps1) } 30378"

[Copilot]

Pull request overview

Fixes MacCatalyst TitleBar content alignment when entering fullscreen by adjusting the TitleBar template’s left inset, and adds a UI test + HostApp repro page for issue #30248.

Changes:

• Update TitleBar (MacCatalyst) to toggle the template root margin based on fullscreen state.
• Add HostApp issue page Issue30248 that sets a custom Window.TitleBar.
• Add a MacCatalyst UI test with a corresponding approved snapshot.

Reviewed changes

Copilot reviewed 3 out of 4 changed files in this pull request and generated 4 comments.

File	Description
src/Controls/src/Core/TitleBar/TitleBar.cs	Adds MacCatalyst fullscreen-aware margin adjustment for TitleBar content.
src/Controls/tests/TestCases.HostApp/Issues/Issue30248.cs	New HostApp repro page that assigns a TitleBar and provides UI to screenshot.
src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue30248.cs	New MacCatalyst UI test that enters fullscreen and verifies via screenshot.
src/Controls/tests/TestCases.Mac.Tests/snapshots/mac/VerifyTitleBarContentinFullScreenmode.png	New baseline snapshot for the added UI test.

[devanathan-vaithiyanathan]

Could you please resolve conflicts?

@kubaflo , I have resolved the conflicts

[kubaflo]

/review -b feature/refactor-copilot-yml

[vishnumenon2684]

/azp run maui-pr-uitests

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).

[github-actions]

Tests Failure Analysis

@devanathan-vaithiyanathan — test-failure review results are available based on commit b4c4f23.
To request a fresh review after new comments, commits, or CI runs, comment /review tests.

Test Failure Review: Likely PR-caused - click to expand

Overall verdict: Likely PR-caused

VerifyTitleBarLTR (from Issue30399) fails with a 2.38% visual snapshot difference: the PR adds an 80px left margin to TitleBar.cs in non-fullscreen mode (Mac Catalyst), which shifts TitleBar content and invalidates the existing LTR baseline. The remaining 16 failures — macOS WebView timeouts, Picker/Page flakiness, Android ADB infrastructure errors, and job cancellations — have no overlap with TitleBar changes.

Failure	Verdict	Evidence
VerifyTitleBarLTR (macOS, Issue30399)	Likely PR-caused	macOS UITests Controls ViewBaseTests,VisualStateManager,Window: VisualTestUtils.VisualTestFailedException: Snapshot different than baseline: VerifyTitleBarLTR.png (2.38% difference). PR modifies TitleBar.cs to add an 80px left margin when not in fullscreen, directly changing the LTR visual layout compared to the stored baseline. Occurred in 4 runs (2 retry attempts).
macOS WebView tests (14 distinct failures)	Likely unrelated	macOS UITests Controls WebView: App became unresponsive and was force-terminated; Appium session timeouts up to 600s. PR changes no WebView code. All 5 recent maui-pr-uitests runs on main also failed.
PickerDialogDoesNotCrashWhenPagePoppedWhileDialogOpen (macOS)	Likely unrelated	macOS UITests Controls Page,Performance,Picker,ProgressBar: System.NullReferenceException. No Picker or Page code changed by this PR.
DisplayAlertAsyncShouldNotCrashWhenPageUnloaded (macOS)	Likely unrelated	Same job as above: System.TimeoutException: Timed out waiting for element. No Page/Alert code changed by this PR.
Android UITests CoreClr Controls (API 30) SearchBar,Shape,Slider	Likely unrelated	Android job: Error ensuring ADB keys: Failed to push ADB keys after multiple attempts. — repeated Android emulator infrastructure failure. No Android code changed by this PR.
Android UITests CoreClr Controls (API 30) CollectionView	Likely unrelated	Android job: Same ADB key push failure pattern as above.
macOS UITests Controls CollectionView (CANCELLED)	Likely unrelated	Job cancelled: Ran longer than 180-minute maximum. No TitleBar code in CollectionView.
macOS UITests Controls Layout (CANCELLED)	Likely unrelated	Job cancelled: Ran longer than 180-minute maximum. No TitleBar code in Layout.

Recommended action

Update the VerifyTitleBarLTR.png baseline in src/Controls/tests/TestCases.Mac.Tests/snapshots/mac/ to reflect the new TitleBar left margin introduced by this PR; all other failures are infrastructure or environment issues unrelated to the PR changes.

Evidence details

Build: maui-pr-uitests #1475636 — 10.0.90-ci+pr.30378.azdo.1475636, branch refs/pull/30378/merge, head b4c4f231f6f8e1841c534fcfcab1acce0e3a2cf5.

PR scope: 4 changed files — src/Controls/src/Core/TitleBar/TitleBar.cs (Mac Catalyst 16+ margin logic), src/Controls/tests/TestCases.HostApp/Issues/Issue30248.cs, src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue30248.cs, and src/Controls/tests/TestCases.Mac.Tests/snapshots/mac/VerifyTitleBarContentinFullScreenmode.png (new snapshot for fullscreen mode).

VerifyTitleBarLTR causation: The failing test is in Issue30399.cs (not modified by this PR) and calls VerifyScreenshot("VerifyTitleBarLTR.png"). The PR's margin logic applies an 80px left margin in non-fullscreen mode, which is the state used during the LTR test, shifting TitleBar content position and producing a 2.38% visual deviation from the stored baseline. The fix is to run the test locally, accept the new rendering, and commit the updated VerifyTitleBarLTR.png to src/Controls/tests/TestCases.Mac.Tests/snapshots/mac/.

macOS WebView failures (14 tests): All stem from Appium/app unresponsiveness — StaleElementReferenceException, App.AppState query did not complete — app is likely unresponsive, WebDriverException after 600s timeout. This pattern is consistent with a flaky macOS WebView environment. No WebView-related files were changed by this PR.

Base branch comparison: All 5 most recent maui-pr-uitests runs on main (builds 1465238, 1459939, 1455207, 1454908, 1451775) are also failed/completed, indicating many of these failures predate this PR.

Android infrastructure failures: Both Android API 30 jobs (SearchBar,Shape,Slider and CollectionView) show Failed to push ADB keys after multiple attempts — a CI emulator provisioning issue not related to any Mac code changes.

Limitation: AzDO _apis/test APIs were not available (unauthenticated access); test failure counts are derived from log parsing only. Authenticated AzDO test run data could surface additional failures not captured here.

[kubaflo]

Looks like the test is failing

[devanathan-vaithiyanathan]

Looks like the test is failing

@kubaflo ,
I verified the test locally and the pop-up does not appear. I have attached a video for reference.
CI generated image:

Video reference:

Screen.Recording.2026-06-23.at.7.54.20.PM.mov

[kubaflo]

@devanathan-vaithiyanathan might be something with the test setup - could you modify the test so that it will pass on CI?

[Copilot]

Pull request overview

Copilot reviewed 3 out of 4 changed files in this pull request and generated 1 comment.

[devanathan-vaithiyanathan]

@devanathan-vaithiyanathan might be something with the test setup - could you modify the test so that it will pass on CI?

@kubaflo , it seems the test is failing because of test case Issue30248. In that test, we enter full-screen mode, so the cursor remains positioned over the full-screen button. As a result, the pop-up appears in the next test case.

To avoid this, I added an empty button and click it to move the cursor away from the full-screen button.