Repository navigation
Document StartVideoRecording start-acknowledgment return semantics - #669
Gerald Versluis (jfversluis) merged 2 commits into
Conversation
CameraView docs: note that StartVideoRecording returns only after the platform confirms the recording has started, not when the start command is issued. This documents the behavior introduced by CommunityToolkit/Maui#3311 (await native video recording start acknowledgment). Co-Authored-By: Claude Code <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 ac13ffd: ✅ Validation status: passed
For more details, please refer to the build report. |
…auto-start, Windows stop, restore failure) and move the start note away from MicrosoftDocs#669's spot Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
There was a problem hiding this comment.
🟡 Changes recommended
The documentation incorrectly says StartVideoRecording returns only after native acknowledgment, when that guarantee applies to successful completion of its returned task.
1 open issue
What changed in this PR
This docs-only PR explains CameraView’s recording-start acknowledgment behavior introduced by CommunityToolkit/Maui#3311, without changing the API.
Changes:
- Adds a note to the Video Recording section about platform acknowledgment.
- Advises callers to await
StartVideoRecordingbefore proceeding.
| File | Description |
|---|---|
docs/maui/views/camera-view.md |
Documents recording-start timing and guidance to await the returned task. |
Review effort: Balanced
Clarified note about StartVideoRecording behavior. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
|
Learn Build status updates of commit 048c01d: ✅ Validation status: passed
For more details, please refer to the build report. |
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 |
3b13b95
into
MicrosoftDocs:main
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>
…665) * 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> * 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> * 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>
* 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>

Documents the return semantics of
CameraView.StartVideoRecordingintroduced by CommunityToolkit/Maui#3311 ("await native video recording start acknowledgment").Adds a NOTE to the CameraView "Video Recording" section:
StartVideoRecordingreturns only after the platform confirms the recording has started, not when the start command is issued; the caller shouldawaitthe returned task to be sure the recording is active before proceeding.This is a docs-only change. The API surface is unchanged by #3311 (it is an internal
CameraManager/VideoRecordingStatebehavior), so no other doc updates are needed.