Skip to content

CommunityToolkit.Maui Docs Updates for Device Tests Fixes + Findings - #665

Merged
Gerald Versluis (jfversluis) merged 87 commits into
MicrosoftDocs:mainfrom
TheCodeTraveler:docs/pr-3344
Nov 11, 2026
Merged

Gerald Versluis (jfversluis) merged 87 commits into
MicrosoftDocs:mainfrom
TheCodeTraveler:docs/pr-3344

Conversation

@TheCodeTraveler

@TheCodeTraveler Brandon Minnick (TheCodeTraveler) commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

This PR coincides with the work done in CommunityToolkit.Maui PR CommunityToolkit/Maui#3344.

The CommunityToolkit.Maui PR adds device tests and fixes bugs/regressions that the tests uncovered.

The Docs updates in this PR also fills gaps where we discovered we are missing documentation.

…ugh ErrorOccurred

StartCameraPreview reports a preview that cannot start (no camera, no camera permission, a camera
that cannot be opened) through ErrorOccurred on every platform instead of throwing. A first start
that fails because of the selected camera follows SelectedCamera; a denied permission stays stopped.
On Android a start that failed only for lack of the camera permission starts by itself when the app
resumes with the permission granted.

Adds the missing ErrorOccurred event to the Events table.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…with the handler's e parameter

`catch(Exception e)` inside a method whose EventArgs parameter is named e does not compile (CS0136).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…port each failure once

CaptureImageCommand, StartCameraPreviewCommand, StopCameraPreviewCommand, StartVideoRecordingCommand and
StopVideoRecordingCommand report a failure once, through MediaCaptureFailed or ErrorOccurred, and a
failure that a command reports does not end a pending CaptureImage.

Fixes the Commands table, which listed no parameter for the commands that take a CancellationToken
and called the Stream of StartVideoRecordingCommand optional, and the return type of CaptureImage.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…nd a camera switch

StopCameraPreview cancels a StartCameraPreview, a StartVideoRecording, the start that the view makes
when it connects its camera and a camera switch that still wait for the platform, and on Android the
restart for a new ImageCaptureResolution and the start that waits for the camera permission. An
awaiting caller gets an OperationCanceledException; the commands do not report it as an error.

On iOS and Mac Catalyst, StartCameraPreview with an already cancelled token throws an
OperationCanceledException and does not start the preview.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
CameraProvider reads the zoom range of a camera through JavaCast, which trimming keeps. In a Release
app, every camera used to report a range of 1 to 1 (#2389), which clamped every ZoomFactor to 1.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
… Source change is reported through MediaFailed

The exception no longer reaches the code that set Source (a breaking change): the MediaElement logs it,
applies the source anyway and reports the first exception once through MediaFailed when the change has
ended, without setting CurrentState to Failed. Applies to StateChanged, PropertyChanging,
PropertyChanged, MediaFailed and, on Android, MediaOpened handlers.

Also notes that on Windows a late rate notification no longer undoes a newer Speed.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…e step for iOS, and explain why

The toolkit sets the status bar style through the view controllers of the app (on .NET 10 by replacing
preferredStatusBarStyle at runtime), which UIKit uses unless Info.plist sets
UIViewControllerBasedStatusBarAppearance to false. An app built with the iOS 27 SDK (Xcode 27) ignores
UIApplication.SetStatusBarStyle, so the documented key now has to go; the toolkit writes a trace message
when it finds the key. Adds a short FAQ entry for it.

Also documents that ApplyOn.OnPageNavigatedTo applies nothing for a NavigatedTo that .NET MAUI raises
before the page loads, and fixes the type of ApplyOn in the Properties table (StatusBarApplyOn).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…e status bar on Android

The dialog of a modal page is laid out like the activity's window since #3189, whatever the status bar
color: its content extends behind the system bars and the page receives the status bar inset. A modal
page that relied on the old padding must keep clear of the status bar itself, with the safe area.

Also corrects the usage: the DialogFragmentService is registered only when
SetShouldUseStatusBarBehaviorOnAndroidModalPage(true) is called; the default is false since 2025.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
BadgeUpdateManager needs package identity. SetCount of an unpackaged app (the default of the .NET MAUI
template) used to end the process with a COMException 0x80070490; it now writes one trace line and does
nothing else. Adds a Windows tab to the preconditions, a note on SetCount and a short FAQ entry.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Windows: Tab stop, Enter and Space toggle it, UI Automation ExpandCollapse and Invoke. Android: TalkBack
announces collapsed or expanded and offers the expand or collapse action. iOS and Mac Catalyst: VoiceOver
reads the header as one button, with the expanded state from iOS 18.

Documents that HandleHeaderTapped also runs for these activations (no tap parameter, no position except
the header center on Windows), the changes that UI tests can see, that UseMauiCommunityToolkit registers a
handler for the internal layout of the Expander, and that an implicit Grid Style does not reach it.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…s ViewOrder sets the Tab order

On Windows, ViewOrder sets the keyboard Tab order of the views, and Narrator's scan order follows the
visual tree. On Android the order applies from Android 5.1 (API 22); on iOS and Mac Catalyst the views
of ViewOrder are the first accessibility elements. Views that are not in ViewOrder stay accessible.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
The views of ViewOrder that the container holds come first among its own Tab stops, followed by the rest
of its content, so Tab reaches the controls above the container before them and the controls below it
after them. A view inside a control within the container (a ScrollView), or outside the container, gets
a TabIndex instead.

This documents the Windows mechanism of the semanticorder branch of push 3; drop this commit if that
change moves out of #3344.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…xt, and that CornerRadius needs 0 or more

An empty ImageSource (IsEmpty), or one that fails to load, shows the Text on every platform; iOS, Mac
Catalyst and Windows used to show an empty circle. Set Text to an empty string for a blank circle.
.NET MAUI's RoundRectangle draws a negative CornerRadius as notched shapes.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…oundColor

The default border color is white (AvatarViewDefaults.BorderColor), not black, and the control sets no
background color of its own.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Added theming information and customization options for popups.
…les and OnInitializing set the same property

Adds "Which value is used" to Setting Popup Defaults, from the XML docs of Popup, DefaultPopupSettings,
PopupOptions and Options and the probes that checked them: DefaultPopupSettings and
DefaultPopupOptionsSettings are defaults that a Style, a value on the Popup or PopupOptions, or a binding
override; OnInitializing is not a default and beats a Style; a Margin of 0 or Fill options are displayed
with the DefaultPopupSettings value; the default background color is not the BackgroundColor of the Popup,
which stays null; the Popup created for a View binds Margin, options, Background, BackgroundColor and
Padding to the View; a tap outside or the Android back button dismisses the Popup only while the Popup and
the PopupOptions both allow it.

Also corrects the tip about a View's background in the theming section: a View with a Background or a
BackgroundColor of any kind, Transparent included, keeps it.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…e from

A tap outside or the Android back button dismisses a Popup only while the PopupOptions and the Popup both
allow it. The options that are not set start with DefaultPopupOptionsSettings, which also are the options
of a Popup that is shown without PopupOptions.

Also fixes the "Disable the Popup Shadow" text, which told the reader to set Shape, and two unfinished
or garbled sentences.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…seStatusBarBehaviorOnAndroidModalPage

The options page lists only three of the options, and the popup defaults and the modal page option of
the status bar are documented on other pages. Adds a short entry for each that links to the page with
the details.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…roid and when the behaviors dismiss the keyboard

HideKeyboardAsync hides the keyboard on Android through the window of the focused view, so it also works
for an input inside a Popup or a modal page, which have a window of their own.

MaxLengthReachedBehavior and UserStoppedTypingBehavior dismiss the keyboard, and remove the focus from the
InputView, only while the InputView has the focus; the keyboard of another input stays open.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…yboardAsync

Both methods return a ValueTask that the samples dropped.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Satellite shows aerial imagery without labels and Hybrid shows labels, as on iOS and Android. The Windows
map used to show the labels for both, so the two looked the same; an app that chose Satellite to get
labels has to choose Hybrid now.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
… the provider tells no path

A written document whose file has no path that its documents provider tells (a document of a cloud
provider, for example) used to make SaveAsync fail with "Unable to resolve absolute path". It is saved
now, and FilePath is the content URI of the document, which the app opens with the ContentResolver.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…mple that set a ProgressBar with it

The progress is reported as a percentage from 0 to 100 on every platform (it used to report a fraction
from 0 to 1 and then 100). The sample assigned it to ProgressBar.Value, which .NET MAUI's ProgressBar
does not have; its Progress property takes a fraction from 0 to 1. Also lists IsCancelled in the result.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…take effect in call order on Windows

On Windows, the Toast of the last Show is displayed and a final Dismiss leaves none; a Snackbar that a
later call replaced or dismissed no longer stays on screen without its action, and Shown and Dismissed
are raised in call order. The Task of a call completes after the earlier overlapping calls, and a call
whose token is cancelled before its turn removes nothing.

Warns that a Show or Dismiss that a Shown or Dismissed handler calls runs after the call that raised the
event, so blocking on its Task inside the handler deadlocks.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
… Android start while connecting)

On Windows, a StartCameraPreview that its own token cancels after the camera opened now stops the
preview it showed and releases the camera; it used to throw and leave the preview running. On Android, a
StartCameraPreview called while the view connects its camera waits for the connection, then starts the
preview.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
A device's, status bar, "an Badge/Toast/Snackbar/FileSaver" in image alt text, SnackBar, "allows customize",
dependant, programatically, "the header tapped", and a stray period after a link in the CameraView intro.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Changing it while the preview runs restarts the preview with the new camera, a camera that cannot be
started is reported through ErrorOccurred, and on Android the change waits until a running video
recording is stopped or replaced.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…mited to the window

While a Popup is displayed, a WidthRequest or HeightRequest larger than the space inside the window
(minus the Margin and the stroke of the Shape) is limited to that space, so the Popup keeps its Margin and
the user can tap outside of it. The values of the properties do not change.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
PopupPage notifies the Popup only the first time it is navigated to, so closing a page or another Popup
that was displayed above it does not raise Opened again.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit ca19094:

✅ Validation status: passed

File Status Preview URL Details
docs/maui/alerts/snackbar.md ✅Succeeded View
docs/maui/alerts/toast.md ✅Succeeded View
docs/maui/behaviors/maximum-length-reached-behavior.md ✅Succeeded View
docs/maui/behaviors/statusbar-behavior.md ✅Succeeded View
docs/maui/behaviors/touch-behavior.md ✅Succeeded View
docs/maui/behaviors/user-stopped-typing-behavior.md ✅Succeeded View
docs/maui/essentials/badge.md ✅Succeeded View
docs/maui/essentials/file-saver.md ✅Succeeded View
docs/maui/essentials/folder-picker.md ✅Succeeded View
docs/maui/extensions/color-animation-extensions.md ✅Succeeded View
docs/maui/extensions/keyboard-extensions.md ✅Succeeded View
docs/maui/get-started.md ✅Succeeded View
docs/maui/imagesources/GravatarImageSource.md ✅Succeeded View
docs/maui/includes/toast-snackbar-setup.md ✅Succeeded View
docs/maui/includes/validation-behavior.md ✅Succeeded View
docs/maui/index.md ✅Succeeded View
docs/maui/options.md ✅Succeeded View
docs/maui/platform-specific/DialogFragment-customization.md ✅Succeeded View
docs/maui/platform-specific/navigation-bar.md ✅Succeeded View
docs/maui/TOC.yml ✅Succeeded View
docs/maui/views/AvatarView.md ✅Succeeded View
docs/maui/views/camera-view.md ✅Succeeded View
docs/maui/views/DrawingView.md ✅Succeeded View
docs/maui/views/Expander.md ✅Succeeded View
docs/maui/views/Map.md ✅Succeeded View

This comment lists only the first 25 files in the pull request.
For more details, please refer to the build report.

Comment thread docs/maui/alerts/snackbar.md Resolved
Comment thread docs/maui/essentials/badge.md Resolved
Comment thread docs/maui/essentials/file-saver.md Resolved
Comment thread docs/maui/essentials/folder-picker.md Resolved
Comment thread docs/maui/index.md Resolved
Comment thread docs/maui/views/Expander.md Resolved
Comment thread docs/maui/views/Popup.md Resolved
Comment thread docs/maui/views/semantic-order-view.md Resolved
…Badge and FileSaver pages

- alerts/snackbar.md: the Duration row is back to its short description. A Duration below 1 ms now dismisses the Snackbar at once on every platform, and the release notes cover the Android change.
- essentials/badge.md: the SetCount row is back to its short description. The Windows preconditions tab and the FAQ already say that only a packaged app can show a badge.
- essentials/file-saver.md: the Android content:// note now lives only in the FilePath row under Properties.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 38c5156:

✅ Validation status: passed

File Status Preview URL Details
docs/maui/alerts/snackbar.md ✅Succeeded View
docs/maui/alerts/toast.md ✅Succeeded View
docs/maui/behaviors/maximum-length-reached-behavior.md ✅Succeeded View
docs/maui/behaviors/statusbar-behavior.md ✅Succeeded View
docs/maui/behaviors/touch-behavior.md ✅Succeeded View
docs/maui/behaviors/user-stopped-typing-behavior.md ✅Succeeded View
docs/maui/essentials/badge.md ✅Succeeded View
docs/maui/essentials/file-saver.md ✅Succeeded View
docs/maui/essentials/folder-picker.md ✅Succeeded View
docs/maui/extensions/color-animation-extensions.md ✅Succeeded View
docs/maui/extensions/keyboard-extensions.md ✅Succeeded View
docs/maui/get-started.md ✅Succeeded View
docs/maui/imagesources/GravatarImageSource.md ✅Succeeded View
docs/maui/includes/toast-snackbar-setup.md ✅Succeeded View
docs/maui/includes/validation-behavior.md ✅Succeeded View
docs/maui/index.md ✅Succeeded View
docs/maui/options.md ✅Succeeded View
docs/maui/platform-specific/DialogFragment-customization.md ✅Succeeded View
docs/maui/platform-specific/navigation-bar.md ✅Succeeded View
docs/maui/TOC.yml ✅Succeeded View
docs/maui/views/AvatarView.md ✅Succeeded View
docs/maui/views/camera-view.md ✅Succeeded View
docs/maui/views/DrawingView.md ✅Succeeded View
docs/maui/views/Expander.md ✅Succeeded View
docs/maui/views/Map.md ✅Succeeded View

This comment lists only the first 25 files in the pull request.
For more details, please refer to the build report.

…anticOrderView and Expander, Gravatar in a Button, and the iOS 26 status bar color over a pressed navigation bar button

- views/camera-view.md: new "Custom platform view" section. With an app's CameraViewHandler.PlatformViewFactory, the camera shows in the factory's view (a MediaPlayerElement on Windows), and the toolkit doesn't dispose that view.
- views/semantic-order-view.md: new "Custom platform view" section. An app's ContentViewHandler.PlatformViewFactory doesn't create the SemanticOrderView's platform view, so ViewOrder applies; derive from SemanticOrderViewHandler to change that view.
- views/Expander.md: an app's LayoutHandler.PlatformViewFactory no longer creates the platform view of the Expander's layout on Windows, iOS and Mac Catalyst, so the header keeps its keyboard and screen reader support.
- imagesources/GravatarImageSource.md: in a Button, the image is requested at the Button's WidthRequest or HeightRequest, or at 80px.
- behaviors/statusbar-behavior.md: FAQ entry on iOS 26 and later, where a status bar color cuts off the glass of a pressed navigation bar button, with the workaround and a link to CommunityToolkit/Maui#3374.
- ms.date is 11/07/2026 on each changed page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 5e0da34:

✅ Validation status: passed

File Status Preview URL Details
docs/maui/alerts/snackbar.md ✅Succeeded View
docs/maui/alerts/toast.md ✅Succeeded View
docs/maui/behaviors/maximum-length-reached-behavior.md ✅Succeeded View
docs/maui/behaviors/statusbar-behavior.md ✅Succeeded View
docs/maui/behaviors/touch-behavior.md ✅Succeeded View
docs/maui/behaviors/user-stopped-typing-behavior.md ✅Succeeded View
docs/maui/essentials/badge.md ✅Succeeded View
docs/maui/essentials/file-saver.md ✅Succeeded View
docs/maui/essentials/folder-picker.md ✅Succeeded View
docs/maui/extensions/color-animation-extensions.md ✅Succeeded View
docs/maui/extensions/keyboard-extensions.md ✅Succeeded View
docs/maui/get-started.md ✅Succeeded View
docs/maui/imagesources/GravatarImageSource.md ✅Succeeded View
docs/maui/includes/toast-snackbar-setup.md ✅Succeeded View
docs/maui/includes/validation-behavior.md ✅Succeeded View
docs/maui/index.md ✅Succeeded View
docs/maui/options.md ✅Succeeded View
docs/maui/platform-specific/DialogFragment-customization.md ✅Succeeded View
docs/maui/platform-specific/navigation-bar.md ✅Succeeded View
docs/maui/TOC.yml ✅Succeeded View
docs/maui/views/AvatarView.md ✅Succeeded View
docs/maui/views/camera-view.md ✅Succeeded View
docs/maui/views/DrawingView.md ✅Succeeded View
docs/maui/views/Expander.md ✅Succeeded View
docs/maui/views/Map.md ✅Succeeded View

This comment lists only the first 25 files in the pull request.
For more details, please refer to the build report.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The API reference contradicts the detailed recording guidance on cancellation and platform-specific failures, potentially misleading callers about recording state, recoverable output, and exceptions.

2 open issues
What changed in this PR

This documentation-only PR accompanies CommunityToolkit/Maui#3344, documenting behavior clarified by device tests and the resulting fixes.

Changes:

  • Expands guidance on control lifecycles, cancellation, accessibility, theming, and platform-specific behavior.
  • Updates platform support and Windows Maps deprecation and migration guidance.
  • Corrects examples, API descriptions, links, and wording.
File Description
docs/​maui/​views/​semantic-order-view.md Explains platform ordering and custom handlers.
docs/​maui/​views/​popup/​popup-result.md Corrects Popup link casing.
docs/​maui/​views/​popup/​popup-options.md Clarifies defaults, dismissal, and shadow settings.
docs/​maui/​views/​popup/​popup-complex.md Corrects Popup link casing.
docs/​maui/​views/​Popup.md Documents navigation, defaults, theming, and lifecycle behavior.
docs/​maui/​views/​MediaElement.md Updates platform support, error handling, and playback behavior.
docs/​maui/​views/​Map.md Adds migration guidance and map-type behavior.
docs/​maui/​views/​Expander.md Explains accessibility, automation, and event behavior.
docs/​maui/​views/​DrawingView.md Documents image sizing and pointer handling.
docs/​maui/​views/​camera-view.md Expands preview, recording, cancellation, and error guidance.
docs/​maui/​views/​AvatarView.md Clarifies defaults and image fallback behavior.
docs/​maui/​TOC.yml Marks Windows Maps as deprecated.
docs/​maui/​platform-specific/​navigation-bar.md Explains modern Android navigation-bar behavior.
docs/​maui/​platform-specific/​DialogFragment-customization.md Clarifies opt-in setup and modal safe areas.
docs/​maui/​options.md Adds popup and Android modal configuration options.
docs/​maui/​index.md Updates supported-platform requirements.
docs/​maui/​includes/​validation-behavior.md Documents revalidation after rule changes.
docs/​maui/​includes/​toast-snackbar-setup.md Removes Tizen setup guidance.
docs/​maui/​imagesources/​GravatarImageSource.md Clarifies empty sources, sizing, normalization, and cancellation.
docs/​maui/​get-started.md Adds Windows Maps migration guidance.
docs/​maui/​extensions/​keyboard-extensions.md Corrects examples and explains threading behavior.
docs/​maui/​extensions/​color-animation-extensions.md Documents rate validation and cancellation.
docs/​maui/​essentials/​folder-picker.md Removes Tizen setup guidance.
docs/​maui/​essentials/​file-saver.md Clarifies progress, Android URIs, and cancellation results.
docs/​maui/​essentials/​badge.md Explains Windows packaging and Android launcher discovery.
docs/​maui/​behaviors/​user-stopped-typing-behavior.md Clarifies focus handling and threshold validation.
docs/​maui/​behaviors/​touch-behavior.md Documents restoration of child input transparency.
docs/​maui/​behaviors/​statusbar-behavior.md Updates platform configuration and troubleshooting.
docs/​maui/​behaviors/​maximum-length-reached-behavior.md Clarifies keyboard dismissal and focus handling.
docs/​maui/​alerts/​toast.md Documents Windows call ordering and notification isolation.
docs/​maui/​alerts/​snackbar.md Explains Windows ordering, cancellation, and deadlock avoidance.

Review effort: Balanced

Comment thread docs/maui/views/camera-view.md Resolved
Comment thread docs/maui/views/camera-view.md Resolved
…deoRecording match the Video Recording rules

Copilot (MicrosoftDocs#665 review 5818652025) found the Methods table simpler than the Video Recording section:
- StartVideoRecording (both overloads): a start that has to turn the camera on throws the platform's failure (UnauthorizedAccessException on Windows when the privacy settings block the camera), and on Android a start without a camera returns without recording.
- StopVideoRecording: a token cancelled while a start or an earlier stop still waits stops nothing, and on Android, iOS and Mac Catalyst a token cancelled while the video is copied leaves a partial stream and the next stop returns Stream.Null.
Each row now says so and links to Video Recording. ms.date is 11/08/2026.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit f4678c2:

✅ Validation status: passed

File Status Preview URL Details
docs/maui/alerts/snackbar.md ✅Succeeded View
docs/maui/alerts/toast.md ✅Succeeded View
docs/maui/behaviors/maximum-length-reached-behavior.md ✅Succeeded View
docs/maui/behaviors/statusbar-behavior.md ✅Succeeded View
docs/maui/behaviors/touch-behavior.md ✅Succeeded View
docs/maui/behaviors/user-stopped-typing-behavior.md ✅Succeeded View
docs/maui/essentials/badge.md ✅Succeeded View
docs/maui/essentials/file-saver.md ✅Succeeded View
docs/maui/essentials/folder-picker.md ✅Succeeded View
docs/maui/extensions/color-animation-extensions.md ✅Succeeded View
docs/maui/extensions/keyboard-extensions.md ✅Succeeded View
docs/maui/get-started.md ✅Succeeded View
docs/maui/imagesources/GravatarImageSource.md ✅Succeeded View
docs/maui/includes/toast-snackbar-setup.md ✅Succeeded View
docs/maui/includes/validation-behavior.md ✅Succeeded View
docs/maui/index.md ✅Succeeded View
docs/maui/options.md ✅Succeeded View
docs/maui/platform-specific/DialogFragment-customization.md ✅Succeeded View
docs/maui/platform-specific/navigation-bar.md ✅Succeeded View
docs/maui/TOC.yml ✅Succeeded View
docs/maui/views/AvatarView.md ✅Succeeded View
docs/maui/views/camera-view.md ✅Succeeded View
docs/maui/views/DrawingView.md ✅Succeeded View
docs/maui/views/Expander.md ✅Succeeded View
docs/maui/views/Map.md ✅Succeeded View

This comment lists only the first 25 files in the pull request.
For more details, please refer to the build report.

@TheCodeTraveler
Brandon Minnick (TheCodeTraveler) marked this pull request as ready for review November 9, 2026 00:39
@TheCodeTraveler

Copy link
Copy Markdown
Contributor Author

Gerald Versluis (@jfversluis) This PR is ready to merge

Brings in MicrosoftDocs#669 (camera-view.md: StartVideoRecording start-acknowledgment note) and MicrosoftDocs#664 (Popup.md: Theming).

Popup.md conflict:
- "Which value is used": only this branch adds it; kept.
- Plain View TIP: kept this branch's rule (neither BackgroundColor nor Background) and main's point that a BackgroundColor of Colors.Transparent also replaces the theme-aware background. CommunityToolkit.Maui PopupPage.CreatePopupFromView binds both to the view, and BackgroundColorConverter uses any non-null color.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…atch CommunityToolkit.Maui main

- Popup.md plain-View TIP: a BackgroundColor or Background that a Style sets also replaces the theme-aware background (PopupPage.CreatePopupFromView binds the view's effective values). The implicit Label style of the .NET MAUI app template sets BackgroundColor to Transparent, so the page's first example shows no theme-aware background in a template app.
- camera-view.md MicrosoftDocs#669 note: the task completes only after the platform confirms the start, except on Android without a camera (returns without recording) and without the camera permission (records no video; StopVideoRecording throws a CameraException), as the ICameraView docs on main say.
- ms.date of both pages is 11/11/2026.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…PageACommunityToolkitPopupPage

- dotnet/maui#34073 (OnNavigatingFrom reported the wrong DestinationPage) was fixed in .NET MAUI 10.0.60 (.NET 10 SR6). The toolkit now builds on .NET MAUI 10.0.90 and 11.0.0, and its IsDestinationPageACommunityToolkitPopupPage test for Shell runs without a skip.
- The prose named WasPreviousPageAToolkitPopup(), which doesn't exist; the sample below it already calls WasPreviousPageACommunityToolkitPopupPage().

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
auto-merge was automatically disabled November 11, 2026 20:11

Head branch was pushed to by a user without write access

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 35293bb:

✅ Validation status: passed

File Status Preview URL Details
docs/maui/alerts/snackbar.md ✅Succeeded View
docs/maui/alerts/toast.md ✅Succeeded View
docs/maui/behaviors/maximum-length-reached-behavior.md ✅Succeeded View
docs/maui/behaviors/statusbar-behavior.md ✅Succeeded View
docs/maui/behaviors/touch-behavior.md ✅Succeeded View
docs/maui/behaviors/user-stopped-typing-behavior.md ✅Succeeded View
docs/maui/essentials/badge.md ✅Succeeded View
docs/maui/essentials/file-saver.md ✅Succeeded View
docs/maui/essentials/folder-picker.md ✅Succeeded View
docs/maui/extensions/color-animation-extensions.md ✅Succeeded View
docs/maui/extensions/keyboard-extensions.md ✅Succeeded View
docs/maui/get-started.md ✅Succeeded View
docs/maui/imagesources/GravatarImageSource.md ✅Succeeded View
docs/maui/includes/toast-snackbar-setup.md ✅Succeeded View
docs/maui/includes/validation-behavior.md ✅Succeeded View
docs/maui/index.md ✅Succeeded View
docs/maui/options.md ✅Succeeded View
docs/maui/platform-specific/DialogFragment-customization.md ✅Succeeded View
docs/maui/platform-specific/navigation-bar.md ✅Succeeded View
docs/maui/TOC.yml ✅Succeeded View
docs/maui/views/AvatarView.md ✅Succeeded View
docs/maui/views/camera-view.md ✅Succeeded View
docs/maui/views/DrawingView.md ✅Succeeded View
docs/maui/views/Expander.md ✅Succeeded View
docs/maui/views/Map.md ✅Succeeded View

This comment lists only the first 25 files in the pull request.
For more details, please refer to the build report.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@jfversluis
Gerald Versluis (jfversluis) merged commit 04829a3 into MicrosoftDocs:main Nov 11, 2026
3 checks passed
Brandon Minnick (TheCodeTraveler) added a commit to TheCodeTraveler/CommunityToolkitDocs that referenced this pull request Nov 11, 2026
main squash-merged MicrosoftDocs#665 (04829a3), whose tree is identical to docs/pr-3344 at 35293bb, which this branch already contains. The conflicts in TOC.yml, statusbar-behavior.md, badge.md, get-started.md, index.md, Map.md and semantic-order-view.md come only from the squash; this branch's side is kept, so the tree is unchanged and the PR shows only the .NET 11 commits.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Gerald Versluis (jfversluis) pushed a commit that referenced this pull request Nov 11, 2026
* CameraView: document that a preview that can't start is reported through ErrorOccurred

StartCameraPreview reports a preview that cannot start (no camera, no camera permission, a camera
that cannot be opened) through ErrorOccurred on every platform instead of throwing. A first start
that fails because of the selected camera follows SelectedCamera; a denied permission stays stopped.
On Android a start that failed only for lack of the camera permission starts by itself when the app
resumes with the permission granted.

Adds the missing ErrorOccurred event to the Events table.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* CameraView: rename the catch variable of three samples that collides with the handler's e parameter

`catch(Exception e)` inside a method whose EventArgs parameter is named e does not compile (CS0136).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* CameraView: document that the commands let no exception escape and report each failure once

CaptureImageCommand, StartCameraPreviewCommand, StopCameraPreviewCommand, StartVideoRecordingCommand and
StopVideoRecordingCommand report a failure once, through MediaCaptureFailed or ErrorOccurred, and a
failure that a command reports does not end a pending CaptureImage.

Fixes the Commands table, which listed no parameter for the commands that take a CancellationToken
and called the Stream of StartVideoRecordingCommand optional, and the return type of CaptureImage.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* CameraView: document that StopCameraPreview cancels a pending start and a camera switch

StopCameraPreview cancels a StartCameraPreview, a StartVideoRecording, the start that the view makes
when it connects its camera and a camera switch that still wait for the platform, and on Android the
restart for a new ImageCaptureResolution and the start that waits for the camera permission. An
awaiting caller gets an OperationCanceledException; the commands do not report it as an error.

On iOS and Mac Catalyst, StartCameraPreview with an already cancelled token throws an
OperationCanceledException and does not start the preview.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* CameraView: note that the Android zoom range is correct in Release apps

CameraProvider reads the zoom range of a camera through JavaCast, which trimming keeps. In a Release
app, every camera used to report a range of 1 to 1 (#2389), which clamped every ZoomFactor to 1.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* MediaElement: document that an exception of an event handler during a Source change is reported through MediaFailed

The exception no longer reaches the code that set Source (a breaking change): the MediaElement logs it,
applies the source anyway and reports the first exception once through MediaFailed when the change has
ended, without setting CurrentState to Failed. Applies to StateChanged, PropertyChanging,
PropertyChanged, MediaFailed and, on Android, MediaOpened handlers.

Also notes that on Windows a late rate notification no longer undoes a newer Speed.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* StatusBarBehavior: remove the UIViewControllerBasedStatusBarAppearance step for iOS, and explain why

The toolkit sets the status bar style through the view controllers of the app (on .NET 10 by replacing
preferredStatusBarStyle at runtime), which UIKit uses unless Info.plist sets
UIViewControllerBasedStatusBarAppearance to false. An app built with the iOS 27 SDK (Xcode 27) ignores
UIApplication.SetStatusBarStyle, so the documented key now has to go; the toolkit writes a trace message
when it finds the key. Adds a short FAQ entry for it.

Also documents that ApplyOn.OnPageNavigatedTo applies nothing for a NavigatedTo that .NET MAUI raises
before the page loads, and fixes the type of ApplyOn in the Properties table (StatusBarApplyOn).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* DialogFragmentService: document how a modal page is laid out below the status bar on Android

The dialog of a modal page is laid out like the activity's window since #3189, whatever the status bar
color: its content extends behind the system bars and the page receives the status bar inset. A modal
page that relied on the old padding must keep clear of the status bar itself, with the safe area.

Also corrects the usage: the DialogFragmentService is registered only when
SetShouldUseStatusBarBehaviorOnAndroidModalPage(true) is called; the default is false since 2025.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* DialogFragmentService: fix three typos

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* Badge: document that Windows shows a badge only for a packaged app

BadgeUpdateManager needs package identity. SetCount of an unpackaged app (the default of the .NET MAUI
template) used to end the process with a COMException 0x80070490; it now writes one trace line and does
nothing else. Adds a Windows tab to the preconditions, a note on SetCount and a short FAQ entry.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* Expander: document the keyboard and screen reader support

Windows: Tab stop, Enter and Space toggle it, UI Automation ExpandCollapse and Invoke. Android: TalkBack
announces collapsed or expanded and offers the expand or collapse action. iOS and Mac Catalyst: VoiceOver
reads the header as one button, with the expanded state from iOS 18.

Documents that HandleHeaderTapped also runs for these activations (no tap parameter, no position except
the header center on Windows), the changes that UI tests can see, that UseMauiCommunityToolkit registers a
handler for the internal layout of the Expander, and that an implicit Grid Style does not reach it.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* SemanticOrderView: document the platform behavior, and that on Windows ViewOrder sets the Tab order

On Windows, ViewOrder sets the keyboard Tab order of the views, and Narrator's scan order follows the
visual tree. On Android the order applies from Android 5.1 (API 22); on iOS and Mac Catalyst the views
of ViewOrder are the first accessibility elements. Views that are not in ViewOrder stay accessible.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* SemanticOrderView: document how the Windows Tab order is built (W3-R3a)

The views of ViewOrder that the container holds come first among its own Tab stops, followed by the rest
of its content, so Tab reaches the controls above the container before them and the controls below it
after them. A view inside a control within the container (a ScrollView), or outside the container, gets
a TabIndex instead.

This documents the Windows mechanism of the semanticorder branch of push 3; drop this commit if that
change moves out of #3344.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* AvatarView: document that an empty or failed ImageSource shows the Text, and that CornerRadius needs 0 or more

An empty ImageSource (IsEmpty), or one that fails to load, shows the Text on every platform; iOS, Mac
Catalyst and Windows used to show an empty circle. Set Text to an empty string for a blank circle.
.NET MAUI's RoundRectangle draws a negative CornerRadius as notched shapes.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* AvatarView: correct the documented defaults of BorderColor and BackgroundColor

The default border color is white (AvatarViewDefaults.BorderColor), not black, and the control sets no
background color of its own.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* Enhance Popup documentation with theming details

Added theming information and customization options for popups.

* Popup: document which value is used when popup settings, options, Styles and OnInitializing set the same property

Adds "Which value is used" to Setting Popup Defaults, from the XML docs of Popup, DefaultPopupSettings,
PopupOptions and Options and the probes that checked them: DefaultPopupSettings and
DefaultPopupOptionsSettings are defaults that a Style, a value on the Popup or PopupOptions, or a binding
override; OnInitializing is not a default and beats a Style; a Margin of 0 or Fill options are displayed
with the DefaultPopupSettings value; the default background color is not the BackgroundColor of the Popup,
which stays null; the Popup created for a View binds Margin, options, Background, BackgroundColor and
Padding to the View; a tap outside or the Android back button dismisses the Popup only while the Popup and
the PopupOptions both allow it.

Also corrects the tip about a View's background in the theming section: a View with a Background or a
BackgroundColor of any kind, Transparent included, keeps it.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* PopupOptions: document the dismissal rule and where unset options come from

A tap outside or the Android back button dismisses a Popup only while the PopupOptions and the Popup both
allow it. The options that are not set start with DefaultPopupOptionsSettings, which also are the options
of a Popup that is shown without PopupOptions.

Also fixes the "Disable the Popup Shadow" text, which told the reader to set Shape, and two unfinished
or garbled sentences.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* Options: add SetPopupDefaults, SetPopupOptionsDefaults and SetShouldUseStatusBarBehaviorOnAndroidModalPage

The options page lists only three of the options, and the popup defaults and the modal page option of
the status bar are documented on other pages. Adds a short entry for each that links to the page with
the details.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* Keyboard: document that HideKeyboardAsync works inside a Popup on Android and when the behaviors dismiss the keyboard

HideKeyboardAsync hides the keyboard on Android through the window of the focused view, so it also works
for an input inside a Popup or a modal page, which have a window of their own.

MaxLengthReachedBehavior and UserStoppedTypingBehavior dismiss the keyboard, and remove the focus from the
InputView, only while the InputView has the focus; the keyboard of another input stays open.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* KeyboardExtensions: await the samples of HideKeyboardAsync and ShowKeyboardAsync

Both methods return a ValueTask that the samples dropped.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* Map: document what each MapType shows on Windows

Satellite shows aerial imagery without labels and Hybrid shows labels, as on iOS and Android. The Windows
map used to show the labels for both, so the two looked the same; an app that chose Satellite to get
labels has to choose Hybrid now.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* FileSaver: document that FilePath is a content:// URI on Android when the provider tells no path

A written document whose file has no path that its documents provider tells (a document of a cloud
provider, for example) used to make SaveAsync fail with "Unable to resolve absolute path". It is saved
now, and FilePath is the content URI of the document, which the app opens with the ContentResolver.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* FileSaver: document that the progress is a percentage, and fix the sample that set a ProgressBar with it

The progress is reported as a percentage from 0 to 100 on every platform (it used to report a fraction
from 0 to 1 and then 100). The sample assigned it to ProgressBar.Value, which .NET MAUI's ProgressBar
does not have; its Progress property takes a fraction from 0 to 1. Also lists IsCancelled in the result.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* Toast and Snackbar: document that overlapping Show and Dismiss calls take effect in call order on Windows

On Windows, the Toast of the last Show is displayed and a final Dismiss leaves none; a Snackbar that a
later call replaced or dismissed no longer stays on screen without its action, and Shown and Dismissed
are raised in call order. The Task of a call completes after the earlier overlapping calls, and a call
whose token is cancelled before its turn removes nothing.

Warns that a Show or Dismiss that a Shown or Dismissed handler calls runs after the call that raised the
event, so blocking on its Task inside the handler deadlocks.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* CameraView: document two more start details (Windows cancelled start, Android start while connecting)

On Windows, a StartCameraPreview that its own token cancels after the camera opened now stops the
preview it showed and releases the camera; it used to throw and leave the preview running. On Android, a
StartCameraPreview called while the view connects its camera waits for the connection, then starts the
preview.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* Fix typos on the pages that this update touches

A device's, status bar, "an Badge/Toast/Snackbar/FileSaver" in image alt text, SnackBar, "allows customize",
dependant, programatically, "the header tapped", and a stray period after a link in the CameraView intro.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* CameraView: document what changing SelectedCamera does

Changing it while the preview runs restarts the preview with the new camera, a camera that cannot be
started is reported through ErrorOccurred, and on Android the change waits until a running video
recording is stopped or replaced.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* Popup: document that an oversized WidthRequest or HeightRequest is limited to the window

While a Popup is displayed, a WidthRequest or HeightRequest larger than the space inside the window
(minus the Margin and the stroke of the Shape) is limited to that space, so the Popup keeps its Margin and
the user can tap outside of it. The values of the properties do not change.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* Popup: document that Opened is raised once each time the Popup is shown

PopupPage notifies the Popup only the first time it is navigated to, so closing a page or another Popup
that was displayed above it does not raise Opened again.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* DialogFragmentService: add an FAQ entry for modal page content behind the status bar

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* Options: end the samples with a semicolon

`builder.UseMauiCommunityToolkit(options => { ... })` is a statement and does not compile without it.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* CameraView: an awaited start throws OperationCanceledException when the app calls StopCameraPreview, not when the page closes

Closing the page does not cancel a pending start: the handler's disconnection and disposal neither call
StopCameraPreview nor cancel its token (on Windows a start whose MediaCapture was released ends quietly),
so the example names the app's own StopCameraPreview in OnDisappearing or a stop button.

The note under Request permissions no longer says that a start before the permission is granted always
fails: it says that a start that fails for lack of the permission is reported and leaves the preview
stopped, as the code and the XML docs of StartCameraPreview do. StartCameraPreview also throws
InvalidOperationException after the handler was disconnected, as its XML docs say.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* CameraView: the video recording samples catch the OperationCanceledException of a start that StopCameraPreview cancels

Both samples are async void handlers that await StartVideoRecording without a catch. StopCameraPreview now
cancels a recording that has not started, and the exception would escape the handler and end the app,
which the IMPORTANT note under Cancel pending starts tells readers to prevent. They now catch it, and any
other exception, like the CaptureImage and StartCameraPreview samples on the same page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* MediaElement: state the Windows Speed fix as what Speed does, not as a change

"No longer undoes" reads as release notes in a property table. The row now says what holds: a playback
rate that the player reports after a newer Speed was set doesn't change Speed back (MediaManager.windows.cs
applies the queued rate only while the open session still has it).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* StatusBarBehavior: modal page content extends behind the status bar; the iOS style belongs to the app and is set on the main thread

The Android tab said that the Dialog Fragment Service page describes how a modal page is laid out below the
status bar. With the service, the content of a modal page extends behind the status bar and keeps clear of
it with the safe area, which is what that page describes.

From the remarks of StatusBar.SetStyle (.NET 10, the target framework that the toolkit ships): the style
belongs to the whole app, so the status bar of every window shows it, and a call from a thread other than
the main thread throws UIKitThreadAccessException, also in a Release build. StatusBarBehavior calls
SetStyle when its StatusBarStyle changes, so the same holds for the behavior.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* PopupOptions: link to Popup.md with the case of its file name

The page is docs/maui/views/Popup.md. The new link to its Setting Popup Defaults section, and the two older
links next to it, pointed to popup.md, which a case-sensitive file system does not find.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Popup: name both default background colors in the precedence exceptions

"The color fills the background" left open which color. PopupPage fills the background of a Popup that has
neither a BackgroundColor nor a Background with DefaultPopupSettings.BackgroundColor, or with
BackgroundColorDark while the app uses the dark theme (BackgroundColorConverter over an AppThemeColor), and
neither is the default value of Popup.BackgroundColor.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Expander: ExpandedChanged and Command follow IsExpanded; TalkBack's double tap taps the header

OnIsExpandedPropertyChanged runs Command and raises ExpandedChanged for every change of IsExpanded, also one
made by code, as it does on main: the page said that both happen when the header is tapped (and, after the
accessibility update, activated).

The Android row said that "the click of a TapGestureRecognizer on the Header stays available". The click
that MAUI offers TalkBack is the one of the Expander's own recognizer on the header, so a TalkBack double tap
still toggles the Expander; the row now says that.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* SemanticOrderView: the intro no longer says that ViewOrder orders screen readers on Windows

The first sentence read as if ViewOrder set the screen reader order on every platform and, in addition, the
Tab order on Windows. On Windows it sets only the Tab order (Narrator follows the visual tree, as the XML
docs of ViewOrder say), so the sentence now names the platforms of each.

The Windows row adds that only views that can take the keyboard focus are Tab stops: the page's own example
orders two Labels, whose TextBlocks WinUI never focuses, so it changes nothing on Windows.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* FileSaver: tell apps that used the progress as a fraction to divide it by 100

On main, SaveAsync reported totalRead / stream.Length (0 to 1) while it copied the stream and 100 at the
end, on Android and in the shared copy that the other platforms use. It now reports percentages throughout,
so an app that set ProgressBar.Progress to the reported value fills the bar at once.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* DialogFragmentService: the custom service samples compile and use a type pattern instead of { }

The registration sample missed the semicolon after MauiApp.CreateBuilder(). The service sample matched the
dialog's window with the empty property pattern { }, which the toolkit's code style does not use; it now
tests Dialog?.Window against Android.Views.Window, named in full because Microsoft.Maui.Controls.Window is in
scope in a .NET MAUI project.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* KeyboardExtensions: the IsSoftKeyboardShowing sample is a statement that compiles

Like the HideKeyboardAsync and ShowKeyboardAsync samples above it, which now await their ValueTask, the
sample ends with a semicolon and keeps the bool that the method returns.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* CameraView: the Methods table gives what StartVideoRecording and StopVideoRecording throw and return

StopVideoRecordingCommand now reports the failure of StopVideoRecording through MediaCaptureFailed, but the
table did not say when StopVideoRecording fails. From ICameraView and the platform managers: it returns
Stream.Null when no recording runs (Android, iOS, Mac Catalyst and Windows), throws CameraException on
Android, iOS and Mac Catalyst when the recording failed without a usable video, and returns the video
recorded until an early end otherwise. The StartVideoRecording rows also name the CameraException that the
note under Video Recording already gives.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* UserStoppedTypingBehavior: StoppedTypingTimeThreshold must be 0 or more

The PR validates the property (ValidateStoppedTypingTimeThreshold): a negative value, which made Task.Delay
throw or never complete, is now ignored and the previous value kept, without an exception, as the remarks
of the property say.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Apply suggestion from @TheCodeTraveler

* SemanticOrderView: the page description names the Windows Tab order, as the introduction does

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* StatusBarBehavior: Android needs 6.0 (API 23); on Android 5.0-5.1 it does nothing

The Android tab said only that no changes are needed. Brandon decided on 2026-10-30 to drop Android 5.0-5.1
(API 21-22) for StatusBar and StatusBarBehavior (CommunityToolkit/Maui#3344): both already did nothing there,
and StatusBarBehavior is now annotated [SupportedOSPlatform("android23.0")], as StatusBar is.

The tab now says that they require Android 6.0 (API 23) or later and do nothing on Android 5.0-5.1, that an app
which supports those versions still runs there, and what the compiler reports: warning CA1416 for C# that uses
StatusBarBehavior or StatusBar in an app whose minimum Android version is below 23, and none for XAML. Raising the
minimum to 23, or checking OperatingSystem.IsIOS() || OperatingSystem.IsAndroidVersionAtLeast(23) first, removes
the warning; the Android check alone would skip the behavior on iOS, and a project that treats warnings as errors
doesn't build until it does one of them. This was measured with an Android 21 library that references the built
CommunityToolkit.Maui: 5 warnings for unguarded C# (the type, its three properties and StatusBar.SetColor), 0
behind the check, 0 for a page that declares the behavior in XAML, and 0 with minimum 23.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* SemanticOrderView: document the Windows Tab order details (duplicates, null ViewOrder, hidden parts, app-set TabIndex)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Expander: name the not enabled state and the per-state expand/collapse action in the accessibility table

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* DialogFragmentService: only Colors.Transparent counts as transparent for the default light status bars

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Maps: deprecate CommunityToolkit.Maui.Maps on the Map page

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Maps: deprecate CommunityToolkit.Maui.Maps on the Get Started page

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* DrawingView: document pointer handling and rounded image size

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Maps: mark Map as deprecated in the table of contents

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* SemanticOrderView: correct the Windows Tab order details (TabIndex, binding example, held views, when a new ViewOrder applies)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Revert the DialogFragmentService transparent-status-bar paragraph (behavior equals main; never documented before)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Maps and DrawingView docs: name the .NET MAUI Map as the replacement, scope the pointer and image-size notes to what the code does, fix the API link

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Maps docs: recommend Microsoft.Maui.Controls.Maps (Windows since .NET MAUI 10) with the Azure Maps key setup and the Windows limitations

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Maps docs: add the package swap step, scope the MapControl sentence to Windows, drop the unverified Bing key claim, list the Windows limitations

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* CameraView: document how a recording starts and ends (join, replace, auto-start, Windows stop, restore failure) and move the start note away from #669's spot

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Popup: ShowPopupAsync completes as dismissed and Closed is raised when navigation removes the PopupPage; a popup shown from OnDisappearing

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Toast and Snackbar: on Windows each removes only its own notification; Snackbar Duration below 1 ms on Android

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* MediaElement: SeekTo clamping, Play at the end, a source without data

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* NavigationBar, TouchBehavior, validation Flags, ColorAnimation rate, Gravatar, Badge manifest query, keyboard threading: document the behavior changes

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Docs review fixes: scope the Camera start/stop statements to the platforms whose code implements them, fix a typo, move the examples back under Video Recording

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Docs review fixes: scope the Camera error rule to the Android connection wait, say that Android also ends a recording when the preview stops, clarify the Windows restart

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Docs: drop Tizen from the supported versions, add the MediaElement Android 8.0 (API 26) minimum, fix the TextColorTo argument and the repeated Start preview paragraph

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Docs: align the Camera statements with the final camera code (waiting start, turn-off after a recording, stop-preview result on iOS and Mac Catalyst), state the MediaElement Android minimum on its page, document the ColorTo token, update index.md ms.date

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Docs: apply the Opus review findings (SeekTo per platform, ColorTo token, ErrorOccurred restore wording, StartCameraPreview Android failure)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Docs: state the Toast and Snackbar Windows wait for the notification listing, and that the Popup task completes after the navigation

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Docs: Windows starts the camera for a StartVideoRecording on a stopped preview, and a second start joins the first

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Docs: a cancelled StopVideoRecording still stops the recording, and a start during a recording ends the first

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Docs: Popup shown from OnDisappearing only waits for the Page extension methods; Gravatar empty source and requested size

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Docs: remove the Tizen mentions from the pages whose packages ship no Tizen target

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Docs: fix the three ../popup.md links to the real file name Popup.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Docs: GravatarImageSource cancellation note and Popup calls that throw OperationCanceledException when the app cancels the navigation

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Expander: Enter and Space toggle on release, like a Button

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Expander: an app's LayoutHandler.PlatformViewFactory turns off the header's keyboard and screen reader support

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Docs: remove the Tizen tabs, platform mention and EnumToBoolConverter sample value for the .NET 11 release

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Docs: Maps package removed in the .NET 11 release, with the migration to .NET MAUI Map; .NET 11 supported versions

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Docs: describe how the converters and EventToCommandBehavior use the culture in the .NET 11 release

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* EventToCommandBehavior docs: make the EventArgsConverterCulture example complete

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* StatusBarBehavior docs: remove the Android 6.0 note that .NET 11 makes obsolete

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Converter docs: correct the percent-sign culture text and red hue examples

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Converter docs: add the CMYKA culture section and fix the culture intro

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Converter docs: explain the case-insensitive names in math expressions

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Docs: remove iOS 13 and Android 5.1 text made obsolete by the .NET 11 minimums

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Get started docs: drop the duplicate Maps removal sentence

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Docs: version-independent Maps deprecation wording, CMYKA culture section placement, DateTimeOffset wording

- Map and Get started: the package "was deprecated in the toolkit's last .NET 10 release" instead of
  "the previous release", which stops being true after the next release.
- CMYKA: the Culture section sits after the common converter properties, like the other converter
  pages, and gives the percent-sign examples.
- DateTimeOffsetConverter: describe the old calendar behavior as "Earlier versions", like camera-view.md.
- Map: serial comma; H1 matches the "Map (Removed)" title.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Address Vlad's review: no duplicated platform notes on the Snackbar, Badge and FileSaver pages

- alerts/snackbar.md: the Duration row is back to its short description. A Duration below 1 ms now dismisses the Snackbar at once on every platform, and the release notes cover the Android change.
- essentials/badge.md: the SetCount row is back to its short description. The Windows preconditions tab and the FAQ already say that only a packaged app can show a badge.
- essentials/file-saver.md: the Android content:// note now lives only in the FilePath row under Properties.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Docs for push 10 of #3344: platform view factories of CameraView, SemanticOrderView and Expander, Gravatar in a Button, and the iOS 26 status bar color over a pressed navigation bar button

- views/camera-view.md: new "Custom platform view" section. With an app's CameraViewHandler.PlatformViewFactory, the camera shows in the factory's view (a MediaPlayerElement on Windows), and the toolkit doesn't dispose that view.
- views/semantic-order-view.md: new "Custom platform view" section. An app's ContentViewHandler.PlatformViewFactory doesn't create the SemanticOrderView's platform view, so ViewOrder applies; derive from SemanticOrderViewHandler to change that view.
- views/Expander.md: an app's LayoutHandler.PlatformViewFactory no longer creates the platform view of the Expander's layout on Windows, iOS and Mac Catalyst, so the header keeps its keyboard and screen reader support.
- imagesources/GravatarImageSource.md: in a Button, the image is requested at the Button's WidthRequest or HeightRequest, or at 80px.
- behaviors/statusbar-behavior.md: FAQ entry on iOS 26 and later, where a status bar color cuts off the glass of a pressed navigation bar button, with the workaround and a link to CommunityToolkit/Maui#3374.
- ms.date is 11/07/2026 on each changed page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* StatusBar docs: describe the .NET 11 per-window iOS style

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* StatusBar docs: on .NET 11 only .NET MAUI's view controllers follow the window's style

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Culture docs: TextCaseConverter ConverterCulture, TextValidationBehavior IgnoreCase tip, Math converters string parsing

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* CameraView: the API reference rows for StartVideoRecording and StopVideoRecording match the Video Recording rules

Copilot (#665 review 5818652025) found the Methods table simpler than the Video Recording section:
- StartVideoRecording (both overloads): a start that has to turn the camera on throws the platform's failure (UnauthorizedAccessException on Windows when the privacy settings block the camera), and on Android a start without a camera returns without recording.
- StopVideoRecording: a token cancelled while a start or an earlier stop still waits stops nothing, and on Android, iOS and Mac Catalyst a token cancelled while the video is copied leaves a partial stream and the next stop returns Stream.Null.
Each row now says so and links to Video Recording. ms.date is 11/08/2026.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Popup and CameraView: the merged TIP and the #669 note match CommunityToolkit.Maui main

- Popup.md plain-View TIP: a BackgroundColor or Background that a Style sets also replaces the theme-aware background (PopupPage.CreatePopupFromView binds the view's effective values). The implicit Label style of the .NET MAUI app template sets BackgroundColor to Transparent, so the page's first example shows no theme-aware background in a template app.
- camera-view.md #669 note: the task completes only after the platform confirms the start, except on Android without a camera (returns without recording) and without the camera permission (records no video; StopVideoRecording throws a CameraException), as the ICameraView docs on main say.
- ms.date of both pages is 11/11/2026.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Popup: remove the fixed OnNavigatingFrom warning and name WasPreviousPageACommunityToolkitPopupPage

- dotnet/maui#34073 (OnNavigatingFrom reported the wrong DestinationPage) was fixed in .NET MAUI 10.0.60 (.NET 10 SR6). The toolkit now builds on .NET MAUI 10.0.90 and 11.0.0, and its IsDestinationPageACommunityToolkitPopupPage test for Shell runs without a skip.
- The prose named WasPreviousPageAToolkitPopup(), which doesn't exist; the sample below it already calls WasPreviousPageACommunityToolkitPopupPage().

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants