Repository navigation
CommunityToolkit.Maui Docs Updates for .NET 11 - #670
Gerald Versluis (jfversluis) merged 105 commits into
Conversation
…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>
…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 status updates of commit d4a158f: ✅ Validation status: passed
This comment lists only the first 25 files in the pull request. |
PoliCheck Scan ReportThe 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 foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
…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>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> # Conflicts: # docs/maui/behaviors/statusbar-behavior.md # docs/maui/views/semantic-order-view.md
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…he window's style Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
PoliCheck Scan ReportThe 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 foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit 19826e4: ✅ Validation status: passed
This comment lists only the first 25 files in the pull request. |
…ior IgnoreCase tip, Math converters string parsing Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
PoliCheck Scan ReportThe 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.
More information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit 03c4111: ✅ Validation status: passed
This comment lists only the first 25 files in the pull request. |
…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>
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>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
Learn Build status updates of commit 2cd3cb0: ✅ Validation status: passed
This comment lists only the first 25 files in the pull request. |
PoliCheck Scan ReportThe 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.
More information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
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>
|
Learn Build status updates of commit 3f1086b: ✅ Validation status: passed
This comment lists only the first 25 files in the pull request. |
PoliCheck Scan ReportThe 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.
More information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
6c3f0fb
into
MicrosoftDocs:main
This PR coincides with the work done in CommunityToolkit.Maui PR CommunityToolkit/Maui#3331, the .NET 11 release.
It builds on #665, which is merged. Files changed shows only the .NET 11 changes. Its own commits are the 14 from b605b2a onward; the earlier commits come from #665's branch.
CommunityToolkit.Maui.Mapsis removed in the .NET 11 release.Map.mdbecomes a short migration page to .NET MAUI's ownMap(Microsoft.Maui.Controls.Maps; on Windows the WinUI 3MapControlwith Azure Maps, and its limitations there); the Maps tab of Get started and the TOC are updated.ConverterCulture), with an overview on the converters page.EventArgsConverterCultureproperty.🤖 Generated with Claude Code