Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
105 commits
Select commit Hold shift + click to select a range
e8a7344
CameraView: document that a preview that can't start is reported thro…
TheCodeTraveler Oct 23, 2026
dc7e62e
CameraView: rename the catch variable of three samples that collides …
TheCodeTraveler Oct 23, 2026
9c06563
CameraView: document that the commands let no exception escape and re…
TheCodeTraveler Oct 23, 2026
dff0cab
CameraView: document that StopCameraPreview cancels a pending start a…
TheCodeTraveler Oct 23, 2026
7c711c3
CameraView: note that the Android zoom range is correct in Release apps
TheCodeTraveler Oct 23, 2026
cb85d3f
MediaElement: document that an exception of an event handler during a…
TheCodeTraveler Oct 23, 2026
9ed1333
StatusBarBehavior: remove the UIViewControllerBasedStatusBarAppearanc…
TheCodeTraveler Oct 23, 2026
5bad991
DialogFragmentService: document how a modal page is laid out below th…
TheCodeTraveler Oct 23, 2026
5a18c63
DialogFragmentService: fix three typos
TheCodeTraveler Oct 23, 2026
0aceeee
Badge: document that Windows shows a badge only for a packaged app
TheCodeTraveler Oct 23, 2026
1613d09
Expander: document the keyboard and screen reader support
TheCodeTraveler Oct 23, 2026
39ab9c1
SemanticOrderView: document the platform behavior, and that on Window…
TheCodeTraveler Oct 23, 2026
3cd9cd5
SemanticOrderView: document how the Windows Tab order is built (W3-R3a)
TheCodeTraveler Oct 23, 2026
d0bf7a3
AvatarView: document that an empty or failed ImageSource shows the Te…
TheCodeTraveler Oct 23, 2026
dfe695e
AvatarView: correct the documented defaults of BorderColor and Backgr…
TheCodeTraveler Oct 23, 2026
e617af7
Enhance Popup documentation with theming details
TheCodeTraveler Oct 16, 2026
131ad46
Popup: document which value is used when popup settings, options, Sty…
TheCodeTraveler Oct 23, 2026
1942218
PopupOptions: document the dismissal rule and where unset options com…
TheCodeTraveler Oct 23, 2026
7d96987
Options: add SetPopupDefaults, SetPopupOptionsDefaults and SetShouldU…
TheCodeTraveler Oct 23, 2026
3a7de21
Keyboard: document that HideKeyboardAsync works inside a Popup on And…
TheCodeTraveler Oct 23, 2026
c41f6b1
KeyboardExtensions: await the samples of HideKeyboardAsync and ShowKe…
TheCodeTraveler Oct 23, 2026
c5cbf82
Map: document what each MapType shows on Windows
TheCodeTraveler Oct 23, 2026
575f758
FileSaver: document that FilePath is a content:// URI on Android when…
TheCodeTraveler Oct 23, 2026
8a26f27
FileSaver: document that the progress is a percentage, and fix the sa…
TheCodeTraveler Oct 23, 2026
1fff678
Toast and Snackbar: document that overlapping Show and Dismiss calls …
TheCodeTraveler Oct 23, 2026
db32000
CameraView: document two more start details (Windows cancelled start,…
TheCodeTraveler Oct 23, 2026
d80e46d
Fix typos on the pages that this update touches
TheCodeTraveler Oct 23, 2026
9f779f5
CameraView: document what changing SelectedCamera does
TheCodeTraveler Oct 23, 2026
b9dc8b9
Popup: document that an oversized WidthRequest or HeightRequest is li…
TheCodeTraveler Oct 23, 2026
3480ba7
Popup: document that Opened is raised once each time the Popup is shown
TheCodeTraveler Oct 23, 2026
49762f1
DialogFragmentService: add an FAQ entry for modal page content behind…
TheCodeTraveler Oct 23, 2026
2b1e075
Options: end the samples with a semicolon
TheCodeTraveler Oct 23, 2026
41144b9
CameraView: an awaited start throws OperationCanceledException when t…
TheCodeTraveler Oct 23, 2026
46fa6a1
CameraView: the video recording samples catch the OperationCanceledEx…
TheCodeTraveler Oct 23, 2026
cb0e69e
MediaElement: state the Windows Speed fix as what Speed does, not as …
TheCodeTraveler Oct 23, 2026
07954cb
StatusBarBehavior: modal page content extends behind the status bar; …
TheCodeTraveler Oct 23, 2026
626a117
PopupOptions: link to Popup.md with the case of its file name
TheCodeTraveler Oct 23, 2026
27e737d
Popup: name both default background colors in the precedence exceptions
TheCodeTraveler Oct 23, 2026
7d24d2e
Expander: ExpandedChanged and Command follow IsExpanded; TalkBack's d…
TheCodeTraveler Oct 23, 2026
f38eb1a
SemanticOrderView: the intro no longer says that ViewOrder orders scr…
TheCodeTraveler Oct 23, 2026
7fdd56f
FileSaver: tell apps that used the progress as a fraction to divide i…
TheCodeTraveler Oct 23, 2026
84aa6fc
DialogFragmentService: the custom service samples compile and use a t…
TheCodeTraveler Oct 23, 2026
833424a
KeyboardExtensions: the IsSoftKeyboardShowing sample is a statement t…
TheCodeTraveler Oct 23, 2026
d1e4183
CameraView: the Methods table gives what StartVideoRecording and Stop…
TheCodeTraveler Oct 23, 2026
7d1da72
UserStoppedTypingBehavior: StoppedTypingTimeThreshold must be 0 or more
TheCodeTraveler Oct 23, 2026
abced5b
Apply suggestion from @TheCodeTraveler
TheCodeTraveler Oct 23, 2026
a6ddcdd
SemanticOrderView: the page description names the Windows Tab order, …
TheCodeTraveler Oct 24, 2026
fee70ee
StatusBarBehavior: Android needs 6.0 (API 23); on Android 5.0-5.1 it …
TheCodeTraveler Oct 30, 2026
1ac80cd
SemanticOrderView: document the Windows Tab order details (duplicates…
TheCodeTraveler Nov 6, 2026
fbd0dad
Expander: name the not enabled state and the per-state expand/collaps…
TheCodeTraveler Nov 6, 2026
126fba3
DialogFragmentService: only Colors.Transparent counts as transparent …
TheCodeTraveler Nov 6, 2026
1cac275
Maps: deprecate CommunityToolkit.Maui.Maps on the Map page
TheCodeTraveler Nov 6, 2026
d751178
Maps: deprecate CommunityToolkit.Maui.Maps on the Get Started page
TheCodeTraveler Nov 6, 2026
e58e494
DrawingView: document pointer handling and rounded image size
TheCodeTraveler Nov 6, 2026
02b2968
Maps: mark Map as deprecated in the table of contents
TheCodeTraveler Nov 6, 2026
14c0031
SemanticOrderView: correct the Windows Tab order details (TabIndex, b…
TheCodeTraveler Nov 6, 2026
44bf435
Revert the DialogFragmentService transparent-status-bar paragraph (be…
TheCodeTraveler Nov 6, 2026
2669594
Maps and DrawingView docs: name the .NET MAUI Map as the replacement,…
TheCodeTraveler Nov 6, 2026
b12a50b
Maps docs: recommend Microsoft.Maui.Controls.Maps (Windows since .NET…
TheCodeTraveler Nov 6, 2026
bf190c6
Maps docs: add the package swap step, scope the MapControl sentence t…
TheCodeTraveler Nov 6, 2026
9b04c50
CameraView: document how a recording starts and ends (join, replace, …
TheCodeTraveler Nov 6, 2026
2cc0549
Popup: ShowPopupAsync completes as dismissed and Closed is raised whe…
TheCodeTraveler Nov 6, 2026
54e2d28
Toast and Snackbar: on Windows each removes only its own notification…
TheCodeTraveler Nov 6, 2026
e4ef209
MediaElement: SeekTo clamping, Play at the end, a source without data
TheCodeTraveler Nov 6, 2026
35bd523
NavigationBar, TouchBehavior, validation Flags, ColorAnimation rate, …
TheCodeTraveler Nov 6, 2026
cc5a282
Docs review fixes: scope the Camera start/stop statements to the plat…
TheCodeTraveler Nov 6, 2026
8fbb0c2
Docs review fixes: scope the Camera error rule to the Android connect…
TheCodeTraveler Nov 6, 2026
1ce7e84
Merge the Maps deprecation and DrawingView docs into the #3344 docs
TheCodeTraveler Nov 6, 2026
ab37c33
Docs: drop Tizen from the supported versions, add the MediaElement An…
TheCodeTraveler Nov 6, 2026
416adbd
Docs: align the Camera statements with the final camera code (waiting…
TheCodeTraveler Nov 6, 2026
3693c9f
Docs: apply the Opus review findings (SeekTo per platform, ColorTo to…
TheCodeTraveler Nov 6, 2026
2d04951
Docs: state the Toast and Snackbar Windows wait for the notification …
TheCodeTraveler Nov 6, 2026
b8150fd
Docs: Windows starts the camera for a StartVideoRecording on a stoppe…
TheCodeTraveler Nov 6, 2026
f2a1716
Docs: a cancelled StopVideoRecording still stops the recording, and a…
TheCodeTraveler Nov 6, 2026
99111e8
Docs: Popup shown from OnDisappearing only waits for the Page extensi…
TheCodeTraveler Nov 6, 2026
ec487ff
Docs: remove the Tizen mentions from the pages whose packages ship no…
TheCodeTraveler Nov 6, 2026
6422b63
Docs: fix the three ../popup.md links to the real file name Popup.md
TheCodeTraveler Nov 6, 2026
3004ce1
Merge branch 'main' into docs/pr-3344
TheCodeTraveler Nov 6, 2026
8a02840
Docs: GravatarImageSource cancellation note and Popup calls that thro…
TheCodeTraveler Nov 7, 2026
d1d3958
Expander: Enter and Space toggle on release, like a Button
TheCodeTraveler Nov 7, 2026
ca19094
Expander: an app's LayoutHandler.PlatformViewFactory turns off the he…
TheCodeTraveler Nov 7, 2026
b605b2a
Docs: remove the Tizen tabs, platform mention and EnumToBoolConverter…
TheCodeTraveler Nov 7, 2026
7791775
Docs: Maps package removed in the .NET 11 release, with the migration…
TheCodeTraveler Nov 7, 2026
ba70c52
Docs: describe how the converters and EventToCommandBehavior use the …
TheCodeTraveler Nov 7, 2026
b38b3db
EventToCommandBehavior docs: make the EventArgsConverterCulture examp…
TheCodeTraveler Nov 7, 2026
46b8533
StatusBarBehavior docs: remove the Android 6.0 note that .NET 11 make…
TheCodeTraveler Nov 7, 2026
a860e86
Converter docs: correct the percent-sign culture text and red hue exa…
TheCodeTraveler Nov 7, 2026
4025c2c
Converter docs: add the CMYKA culture section and fix the culture intro
TheCodeTraveler Nov 7, 2026
a88ac75
Converter docs: explain the case-insensitive names in math expressions
TheCodeTraveler Nov 7, 2026
60f8ee5
Docs: remove iOS 13 and Android 5.1 text made obsolete by the .NET 11…
TheCodeTraveler Nov 7, 2026
bcafc63
Get started docs: drop the duplicate Maps removal sentence
TheCodeTraveler Nov 7, 2026
464f272
Docs: version-independent Maps deprecation wording, CMYKA culture sec…
TheCodeTraveler Nov 7, 2026
38c5156
Address Vlad's review: no duplicated platform notes on the Snackbar, …
TheCodeTraveler Nov 7, 2026
d4a158f
Merge remote-tracking branch 'origin/docs/pr-3344' into docs/pr-3331
TheCodeTraveler Nov 7, 2026
5e0da34
Docs for push 10 of #3344: platform view factories of CameraView, Sem…
TheCodeTraveler Nov 7, 2026
f6ca084
Merge remote-tracking branch 'origin/docs/pr-3344' into docs/pr-3331
TheCodeTraveler Nov 7, 2026
7423c97
StatusBar docs: describe the .NET 11 per-window iOS style
TheCodeTraveler Nov 7, 2026
19826e4
StatusBar docs: on .NET 11 only .NET MAUI's view controllers follow t…
TheCodeTraveler Nov 7, 2026
03c4111
Culture docs: TextCaseConverter ConverterCulture, TextValidationBehav…
TheCodeTraveler Nov 8, 2026
f4678c2
CameraView: the API reference rows for StartVideoRecording and StopVi…
TheCodeTraveler Nov 8, 2026
5ec209e
Merge branch 'main' into docs/pr-3344
TheCodeTraveler Nov 11, 2026
c52a851
Popup and CameraView: the merged TIP and the #669 note match Communit…
TheCodeTraveler Nov 11, 2026
35293bb
Popup: remove the fixed OnNavigatingFrom warning and name WasPrevious…
TheCodeTraveler Nov 11, 2026
2cd3cb0
Merge remote-tracking branch 'origin/docs/pr-3344' into docs/pr-3331
TheCodeTraveler Nov 11, 2026
3f1086b
Merge branch 'main' into docs/pr-3331
TheCodeTraveler Nov 11, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/maui/TOC.yml
Original file line number Diff line number Diff line change
Expand Up @@ -233,7 +233,7 @@ items:
href: views/Expander.md
- name: "LazyView"
href: views/LazyView.md
- name: "Map (Windows) (Deprecated)"
- name: "Map (Removed)"
href: views/Map.md
- name: "MediaElement"
href: views/MediaElement.md
Expand Down
22 changes: 21 additions & 1 deletion docs/maui/behaviors/event-to-command-behavior.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: EventToCommandBehavior - .NET MAUI Community Toolkit
author: cliffagius
description: "The EventToCommandBehavior is a behavior that allows the user to invoke a Command through an event. It is designed to associate Commands to events exposed by controls that were not designed to support Commands. It allows you to map any arbitrary event on a control to a Command."
ms.date: 04/23/2022
ms.date: 11/10/2026
---

# EventToCommandBehavior
Expand Down Expand Up @@ -121,6 +121,25 @@ When using this `behavior` with selection or tap events exposed by `ListView` an
* [ItemTappedEventArgsConverter](../converters/item-tapped-eventargs-converter.md)
* [SelectedItemEventArgsConverter](../converters/selected-item-eventargs-converter.md)

## Set the culture of the EventArgsConverter

By default, the `EventToCommandBehavior` passes `CultureInfo.InvariantCulture` to the `EventArgsConverter`. A binding passes `CultureInfo.CurrentUICulture` instead, so this default differs from a binding. Set `EventArgsConverterCulture` to pass a different culture.

The following example passes the `de-DE` culture to `MyTextChangedEventArgsConverter`. This converter is your own `IValueConverter`. The toolkit doesn't include it.

```xaml
<Entry x:Name="MyEntry">
<Entry.Behaviors>
<toolkit:EventToCommandBehavior
EventName="TextChanged"
BindingContext="{Binding Path=BindingContext, Source={x:Reference MyEntry}, x:DataType=Entry}"
Command="{Binding TextChangedCommand}"
EventArgsConverter="{StaticResource MyTextChangedEventArgsConverter}"
EventArgsConverterCulture="de-DE" />
</Entry.Behaviors>
</Entry>
```

## Properties

|Property |Type |Description |
Expand All @@ -129,6 +148,7 @@ When using this `behavior` with selection or tap events exposed by `ListView` an
| Command | [ICommand](xref:System.Windows.Input.ICommand) | The `Command` that should be executed. |
| CommandParameter | object | An optional parameter to forward to the `Command`. |
| EventArgsConverter | IValueConverter | An optional `IValueConverter` that can be used to convert `EventArgs` values to values passed into the `Command`. |
| EventArgsConverterCulture | [CultureInfo](xref:System.Globalization.CultureInfo)? | The culture passed to the `EventArgsConverter`. The default is `null`, which means `CultureInfo.InvariantCulture`. |

## Examples

Expand Down
15 changes: 5 additions & 10 deletions docs/maui/behaviors/statusbar-behavior.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: StatusBarBehavior - .NET MAUI Community Toolkit
author: pictos
description: "The StatusBarBehavior provides the ability to customize the color and style of a device's status bar."
ms.date: 11/07/2026
ms.date: 11/10/2026
---

# StatusBarBehavior
Expand Down Expand Up @@ -92,16 +92,11 @@ class MyPage : ContentPage

No changes needed.

> [!IMPORTANT]
> Requires Android 6.0 (API 23) or later; on Android 5.0-5.1 (API 21-22) it does nothing. An app that supports those versions still runs on them, but its status bar keeps the default color and style there.
>
> In C#, an app whose minimum Android version is below 23 gets warning CA1416 for code that uses `StatusBarBehavior` or `StatusBar`, and a project that treats warnings as errors doesn't build. Raise the minimum Android version of the app to 23, or put that code inside `if (OperatingSystem.IsIOS() || OperatingSystem.IsAndroidVersionAtLeast(23))`. Don't check `OperatingSystem.IsAndroidVersionAtLeast(23)` alone in code that also runs on iOS: it's `false` on iOS, so the status bar wouldn't change there. XAML doesn't get the warning.

To apply the status bar color and style of the activity to modal pages as well, see [Dialog Fragment Service](../platform-specific/DialogFragment-customization.md). That page also describes how the content of a modal page extends behind the status bar, and how to keep it clear of the status bar.

# [iOS](#tab/ios)

No changes needed. UIKit takes the style of the status bar from the view controllers of your app, and the toolkit makes them return the style that you set. This works as long as the _Platforms/iOS/Info.plist_ file doesn't turn view controller-based status bar appearance off.
No changes needed. UIKit takes the style of the status bar from the view controllers of your app, and the view controllers of .NET MAUI return the style of the window. This works as long as the _Platforms/iOS/Info.plist_ file doesn't turn view controller-based status bar appearance off.

If your _Platforms/iOS/Info.plist_ file contains the following entry, which earlier versions of this page told you to add, remove it:

Expand All @@ -111,9 +106,9 @@ If your _Platforms/iOS/Info.plist_ file contains the following entry, which earl
```

> [!IMPORTANT]
> In an app that is built with the iOS 27 SDK (Xcode 27) or later, UIKit ignores `UIApplication.SetStatusBarStyle`. With the key set to `false` the style of the status bar then doesn't change, and the toolkit writes the message _Unable to apply the Status Bar Style because Info.plist sets UIViewControllerBasedStatusBarAppearance to false: remove the key from Info.plist_ to the trace output. An app that is built with an earlier SDK still applies the style while the key is `false`, but the key isn't needed there either.
> In an app that is built with the iOS 27 SDK (Xcode 27) or later, UIKit ignores `UIApplication.SetStatusBarStyle`. With the key set to `false` the style of the status bar then doesn't change, and the toolkit writes the message _Unable to apply the Status Bar Style because Info.plist sets UIViewControllerBasedStatusBarAppearance to false: remove the key from Info.plist_ to the trace output. An app that is built with an earlier SDK, such as a .NET 10 app, still applies the style while the key is `false`, but the key isn't needed there either.

On .NET 10, the style belongs to the whole app: the status bar of every window shows it. The first `LightContent` or `DarkContent` that you set makes the view controllers that don't choose a style of their own return the one you set. `Default` gives every view controller its own style back. A view controller that overrides `preferredStatusBarStyle` keeps its own style, and so does `SFSafariViewController`.
The style belongs to a window: `StatusBarBehavior` sets the `Window.StatusBarTheme` of its page's window (`LightContent` sets `StatusBarTheme.Dark`, `DarkContent` sets `StatusBarTheme.Light`, `Default` sets `StatusBarTheme.Default`), and the view controllers of .NET MAUI return the matching style. The other windows keep their theme, and a style that changes while the behavior isn't attached to a page changes no status bar. `StatusBar.SetStyle` sets the theme of every window that is open at the time of the call; a window that opens later keeps its own. `StatusBar.SetStyle` needs `UseMauiCommunityToolkit()` in _MauiProgram.cs_. A view controller that isn't one of .NET MAUI's, such as a system view controller that your app presents, keeps its own style. Before .NET 11, the style belonged to the whole app.

-----

Expand All @@ -129,7 +124,7 @@ On .NET 10, the style belongs to the whole app: the status bar of every window s

### Why doesn't the status bar style change on iOS?

Look for the message _Unable to apply the Status Bar Style because Info.plist sets UIViewControllerBasedStatusBarAppearance to false_ in the trace output. If it's there, remove the `UIViewControllerBasedStatusBarAppearance` key from the _Platforms/iOS/Info.plist_ file, as described in [Configuration](#configuration). If it isn't, check whether a view controller that overrides `preferredStatusBarStyle` is on screen: it keeps its own style.
Look for the message _Unable to apply the Status Bar Style because Info.plist sets UIViewControllerBasedStatusBarAppearance to false_ in the trace output. If it's there, remove the `UIViewControllerBasedStatusBarAppearance` key from the _Platforms/iOS/Info.plist_ file, as described in [Configuration](#configuration). If it isn't, check whether a view controller that isn't one of .NET MAUI's is on screen: it keeps its own style. The style also doesn't change when it was set on another window, or when it changed while the behavior wasn't attached to a page.

### Why is a pressed navigation bar button cut off at the status bar on iOS 26 and later?

Expand Down
5 changes: 4 additions & 1 deletion docs/maui/behaviors/text-validation-behavior.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: TextValidationBehavior - .NET MAUI Community Toolkit
author: bijington
description: "The TextValidationBehavior is a Behavior that allows the user to validate a given text depending on specified parameters."
ms.date: 04/20/2022
ms.date: 11/10/2026
---

# TextValidationBehavior
Expand Down Expand Up @@ -134,6 +134,9 @@ The following screenshot shows the resulting TextValidationBehavior on Android:

[!INCLUDE [common validation properties](../includes/validation-behavior.md)]

> [!TIP]
> `RegexOptions.IgnoreCase` follows the current culture. In Turkish, for example, `^[a-z]+$` doesn't match `TITLE`, because the capital `I` isn't the uppercase of `i`. For patterns that aren't linguistic, use `RegexOptions.IgnoreCase | RegexOptions.CultureInvariant`.

## Examples

You can find an example of this behavior in action in the [.NET MAUI Community Toolkit Sample Application](https://github.com/CommunityToolkit/Maui/blob/main/samples/CommunityToolkit.Maui.Sample/Pages/Behaviors/TextValidationBehaviorPage.xaml).
Expand Down
6 changes: 5 additions & 1 deletion docs/maui/converters/color-to-cmyk-string-converter.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: ColorToCmykStringConverter - .NET MAUI Community Toolkit
author: bijington
description: "The ColorToCmykStringConverter is a one way converter that allows users to convert a Color value binding to its CMYK string equivalent."
ms.date: 04/15/2022
ms.date: 11/10/2026
---

# ColorToCmykStringConverter
Expand All @@ -15,6 +15,10 @@ The `ConvertBack` method is not supported.

[!INCLUDE [common converter properties](../includes/communitytoolkit-converter.md)]

## Culture

The converter formats the percentages with the binding's culture. For example, `de-DE` writes `100 %` with a space before the `%` sign, and `tr-TR` writes `%100`.

## Syntax

The following examples will show how to use the `ColorToCmykStringConverter` to display the CMYK equivalent string of a specific `Color`.
Expand Down
6 changes: 5 additions & 1 deletion docs/maui/converters/color-to-cmyka-string-converter.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: ColorToCmykaStringConverter - .NET MAUI Community Toolkit
author: bijington
description: "The ColorToCmykaStringConverter is a one way converter that allows users to convert a Color value binding to its CMYKA string equivalent."
ms.date: 04/15/2022
ms.date: 11/10/2026
---

# ColorToCmykaStringConverter
Expand All @@ -15,6 +15,10 @@ The `ConvertBack` method is not supported.

[!INCLUDE [common converter properties](../includes/communitytoolkit-converter.md)]

## Culture

The converter formats the percentages and the alpha value with the binding's culture. For example, `de-DE` writes `100 %` with a space before the `%` sign, and `tr-TR` writes `%100`. The alpha value `0.5` is `0,5` in `de-DE`.

## Syntax

The following examples will show how to use the `ColorToCmykaStringConverter` to display the CMYKA equivalent string of a specific `Color`.
Expand Down
8 changes: 6 additions & 2 deletions docs/maui/converters/color-to-hsl-string-converter.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,19 +2,23 @@
title: ColorToHslStringConverter - .NET MAUI Community Toolkit
author: bijington
description: "The ColorToHslStringConverter is a one way converter that allows users to convert a Color value binding to its HSL string equivalent."
ms.date: 04/15/2022
ms.date: 11/10/2026
---

# ColorToHslStringConverter

The `ColorToHslStringConverter` is a one way converter that allows users to convert a `Color` value binding to its HSL `string` equivalent in the format: **HSL(hue,saturation,lightness)** where **hue** will be a value between 0 and 360, and **saturation** and **lightness** will be a value between 0% and 100% (e.g. **HSL(0,100%,50%)** for `Colors.Red`.
The `ColorToHslStringConverter` is a one way converter that allows users to convert a `Color` value binding to its HSL `string` equivalent in the format: **HSL(hue,saturation,lightness)** where **hue** will be a value between 0 and 360, and **saturation** and **lightness** will be a value between 0% and 100% (e.g. **HSL(360,100%,50%)** for `Colors.Red`.

The `Convert` method returns the supplied `Color` `value` converted to its HSL `string` equivalent.

The `ConvertBack` method is not supported.

[!INCLUDE [common converter properties](../includes/communitytoolkit-converter.md)]

## Culture

The converter formats the percentages with the binding's culture. For example, `de-DE` writes `100 %` with a space before the `%` sign, and `tr-TR` writes `%100`.

## Syntax

The following examples will show how to use the `ColorToHslStringConverter` to display the HSL equivalent string of a specific `Color`.
Expand Down
8 changes: 6 additions & 2 deletions docs/maui/converters/color-to-hsla-string-converter.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,19 +2,23 @@
title: ColorToHslaStringConverter - .NET MAUI Community Toolkit
author: bijington
description: "The ColorToHslaStringConverter is a one way converter that allows users to convert a Color value binding to its HSLA string equivalent."
ms.date: 04/15/2022
ms.date: 11/10/2026
---

# ColorToHslaStringConverter

The `ColorToHslaStringConverter` is a one way converter that allows users to convert a `Color` value binding to its HSLA `string` equivalent in the format: **HSLA(hue,saturation,lightness,alpha)** where **hue** will be a value between 0 and 360, **saturation** and **lightness** will be a value between 0% and 100%, and **alpha** will be a value between 0 and 1 (e.g. **HSLA(0,100%,50%,1)** for `Colors.Red`.
The `ColorToHslaStringConverter` is a one way converter that allows users to convert a `Color` value binding to its HSLA `string` equivalent in the format: **HSLA(hue,saturation,lightness,alpha)** where **hue** will be a value between 0 and 360, **saturation** and **lightness** will be a value between 0% and 100%, and **alpha** will be a value between 0 and 1 (e.g. **HSLA(360,100%,50%,1)** for `Colors.Red`.

The `Convert` method returns the supplied `Color` `value` converted to its HSLA `string` equivalent.

The `ConvertBack` method is not supported.

[!INCLUDE [common converter properties](../includes/communitytoolkit-converter.md)]

## Culture

The converter formats the percentages and the alpha value with the binding's culture. For example, `de-DE` writes `100 %` with a space before the `%` sign, and `tr-TR` writes `%100`. The alpha value `0.5` is `0,5` in `de-DE`.

## Syntax

The following examples will show how to use the `ColorToHslaStringConverter` to display the HSLA equivalent string of a specific `Color`.
Expand Down
6 changes: 5 additions & 1 deletion docs/maui/converters/color-to-rgba-string-converter.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: ColorToRgbaStringConverter - .NET MAUI Community Toolkit
author: bijington
description: "The ColorToRgbaStringConverter is a converter that allows users to convert a Color value binding to its RGBA string equivalent."
ms.date: 02/15/2024
ms.date: 11/10/2026
---

# ColorToRgbaStringConverter
Expand All @@ -15,6 +15,10 @@ The `ConvertBack` method returns the RGB `string` `value` converted to a `Color`

[!INCLUDE [common converter properties](../includes/communitytoolkit-converter.md)]

## Culture

The converter formats the alpha value with the binding's culture. In a culture that uses a comma as the decimal separator, such as `de-DE`, the alpha value of 0.5 is written as `0,5`. When it converts back, the converter reads the string that it formats itself, using the same culture.

## Syntax

The following examples will show how to use the `ColorToRgbaStringConverter` to display the RGBA equivalent string of a specific `Color`.
Expand Down
6 changes: 5 additions & 1 deletion docs/maui/converters/compare-converter.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: CompareConverter - .NET MAUI Community Toolkit
author: bijington
description: "The CompareConverter is a one way converter that takes an incoming value implementing IComparable, compares to a specified value, and returns the comparison result."
ms.date: 05/17/2022
ms.date: 11/10/2026
---

# CompareConverter
Expand All @@ -16,6 +16,10 @@ The `ConvertBack` method is not supported.

[!INCLUDE [common converter properties](../includes/communitytoolkit-converter.md)]

## Culture

The converter compares `string` values with the collation of the binding's culture. It compares values of other types without regard to culture.

## Syntax

### XAML
Expand Down
6 changes: 5 additions & 1 deletion docs/maui/converters/datetimeoffsetconverter.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: DateTimeOffsetConverter - .NET MAUI Community Toolkit
author: cliffagius
description: "The DateTimeOffsetConverter is a converter that allows users to convert a DateTimeOffset to a DateTime "
ms.date: 03/22/2022
ms.date: 11/10/2026
---

# DateTimeOffsetConverter
Expand All @@ -11,6 +11,10 @@ The `DateTimeOffsetConverter` is a converter that allows users to convert a `Dat

[!INCLUDE [common converter properties](../includes/communitytoolkit-converter.md)]

## Culture

The converter doesn't use the culture, because the components of a `DateTime` are always Gregorian. Earlier versions applied the calendar of the culture when they converted a `DateTime` back to a `DateTimeOffset`.

## Syntax

### XAML
Expand Down
6 changes: 5 additions & 1 deletion docs/maui/converters/double-to-int-converter.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: DoubleToIntConverter - .NET MAUI Community Toolkit
author: bijington
description: "The DoubleToIntConverter is a converter that allows users to convert an incoming double value to an int and vice-versa."
ms.date: 03/09/2022
ms.date: 11/10/2026
---

# DoubleToIntConverter
Expand All @@ -22,6 +22,10 @@ The `ConvertBack` method returns the supplied `value` converted to a `double` an

[!INCLUDE [common converter properties](../includes/communitytoolkit-converter.md)]

## Culture

When the `ConverterParameter` is a `string`, the converter parses it with the invariant culture first, so `2.5` in XAML means the same number for every user. If that fails, it parses the string with the binding's culture, so `2,5` works in `de-DE`.

## Syntax

### XAML
Expand Down
15 changes: 7 additions & 8 deletions docs/maui/converters/enum-to-bool-converter.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: EnumToBoolConverter - .NET MAUI Community Toolkit
author: VladislavAntonyuk
description: "The EnumToBoolConverter is a one way converter that allows you to convert an Enum to a corresponding bool based on whether it is equal to a set of supplied enum values."
ms.date: 05/04/2022
ms.date: 11/10/2026
---

# EnumToBoolConverter
Expand Down Expand Up @@ -34,7 +34,6 @@ public enum MyDevicePlatform
Android,
iOS,
macOS,
Tizen,
Windows
}
```
Expand Down Expand Up @@ -91,8 +90,8 @@ It is also possible to pass the converter parameter:
<VerticalStackLayout>
<Picker ItemsSource="{Binding Platforms}"
SelectedItem="{Binding SelectedPlatform}" />
<Label IsVisible="{Binding SelectedPlatform, Converter={StaticResource PlatformConverter}, ConverterParameter={x:Static vm:MyDevicePlatform.Tizen}}"
Text="I am visible when the Picker value is Tizen."/>
<Label IsVisible="{Binding SelectedPlatform, Converter={StaticResource PlatformConverter}, ConverterParameter={x:Static vm:MyDevicePlatform.Windows}}"
Text="I am visible when the Picker value is Windows."/>
</VerticalStackLayout>
</ContentPage>
```
Expand All @@ -112,15 +111,15 @@ class EnumToBoolConverterPage : ContentPage

var label = new Label
{
Text = "I am visible when the Picker value is Tizen."
Text = "I am visible when the Picker value is Windows."
};

label.SetBinding(
Label.IsVisibleProperty,
new Binding(
static (ViewModel vm) => vm.SelectedPlatform,
converter: new EnumToBoolConverter(),
converterParameter: MyDevicePlatform.Tizen));
converterParameter: MyDevicePlatform.Windows));

Content = new VerticalStackLayout
{
Expand Down Expand Up @@ -154,12 +153,12 @@ class EnumToBoolConverterPage : ContentPage
static (ViewModel vm) => vm.SelectedPlatform),

new Label()
.Text("I am visible when the Picker value is Tizen.")
.Text("I am visible when the Picker value is Windows.")
.Bind(
Label.IsVisibleProperty,
static (ViewModel vm) => vm.SelectedPlatform,
converter: new EnumToBoolConverter(),
converterParameter: MyDevicePlatform.Tizen)
converterParameter: MyDevicePlatform.Windows)
}
};
}
Expand Down
Loading