diff --git a/docs/maui/TOC.yml b/docs/maui/TOC.yml
index 412a1689..c361797b 100644
--- a/docs/maui/TOC.yml
+++ b/docs/maui/TOC.yml
@@ -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
diff --git a/docs/maui/behaviors/event-to-command-behavior.md b/docs/maui/behaviors/event-to-command-behavior.md
index c6c9843e..554ddab2 100644
--- a/docs/maui/behaviors/event-to-command-behavior.md
+++ b/docs/maui/behaviors/event-to-command-behavior.md
@@ -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
@@ -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
+
+
+
+
+
+```
+
## Properties
|Property |Type |Description |
@@ -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
diff --git a/docs/maui/behaviors/statusbar-behavior.md b/docs/maui/behaviors/statusbar-behavior.md
index cea7ba1c..f27630c5 100644
--- a/docs/maui/behaviors/statusbar-behavior.md
+++ b/docs/maui/behaviors/statusbar-behavior.md
@@ -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
@@ -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:
@@ -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.
-----
@@ -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?
diff --git a/docs/maui/behaviors/text-validation-behavior.md b/docs/maui/behaviors/text-validation-behavior.md
index 781dae3f..a26e2eae 100644
--- a/docs/maui/behaviors/text-validation-behavior.md
+++ b/docs/maui/behaviors/text-validation-behavior.md
@@ -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
@@ -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).
diff --git a/docs/maui/converters/color-to-cmyk-string-converter.md b/docs/maui/converters/color-to-cmyk-string-converter.md
index 8c917f1c..25f089b3 100644
--- a/docs/maui/converters/color-to-cmyk-string-converter.md
+++ b/docs/maui/converters/color-to-cmyk-string-converter.md
@@ -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
@@ -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`.
diff --git a/docs/maui/converters/color-to-cmyka-string-converter.md b/docs/maui/converters/color-to-cmyka-string-converter.md
index 633fa929..23a63800 100644
--- a/docs/maui/converters/color-to-cmyka-string-converter.md
+++ b/docs/maui/converters/color-to-cmyka-string-converter.md
@@ -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
@@ -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`.
diff --git a/docs/maui/converters/color-to-hsl-string-converter.md b/docs/maui/converters/color-to-hsl-string-converter.md
index 30a01263..f56ee72a 100644
--- a/docs/maui/converters/color-to-hsl-string-converter.md
+++ b/docs/maui/converters/color-to-hsl-string-converter.md
@@ -2,12 +2,12 @@
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.
@@ -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 `ColorToHslStringConverter` to display the HSL equivalent string of a specific `Color`.
diff --git a/docs/maui/converters/color-to-hsla-string-converter.md b/docs/maui/converters/color-to-hsla-string-converter.md
index ea188edf..f5ad84e2 100644
--- a/docs/maui/converters/color-to-hsla-string-converter.md
+++ b/docs/maui/converters/color-to-hsla-string-converter.md
@@ -2,12 +2,12 @@
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.
@@ -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 `ColorToHslaStringConverter` to display the HSLA equivalent string of a specific `Color`.
diff --git a/docs/maui/converters/color-to-rgba-string-converter.md b/docs/maui/converters/color-to-rgba-string-converter.md
index 35528442..9cb59abe 100644
--- a/docs/maui/converters/color-to-rgba-string-converter.md
+++ b/docs/maui/converters/color-to-rgba-string-converter.md
@@ -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
@@ -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`.
diff --git a/docs/maui/converters/compare-converter.md b/docs/maui/converters/compare-converter.md
index 42f9fea7..6f2b538b 100644
--- a/docs/maui/converters/compare-converter.md
+++ b/docs/maui/converters/compare-converter.md
@@ -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
@@ -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
diff --git a/docs/maui/converters/datetimeoffsetconverter.md b/docs/maui/converters/datetimeoffsetconverter.md
index 7dfa5cce..57ed3ce4 100644
--- a/docs/maui/converters/datetimeoffsetconverter.md
+++ b/docs/maui/converters/datetimeoffsetconverter.md
@@ -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
@@ -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
diff --git a/docs/maui/converters/double-to-int-converter.md b/docs/maui/converters/double-to-int-converter.md
index aa677e3d..23d98a5a 100644
--- a/docs/maui/converters/double-to-int-converter.md
+++ b/docs/maui/converters/double-to-int-converter.md
@@ -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
@@ -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
diff --git a/docs/maui/converters/enum-to-bool-converter.md b/docs/maui/converters/enum-to-bool-converter.md
index 7d2b31e0..290e9f8b 100644
--- a/docs/maui/converters/enum-to-bool-converter.md
+++ b/docs/maui/converters/enum-to-bool-converter.md
@@ -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
@@ -34,7 +34,6 @@ public enum MyDevicePlatform
Android,
iOS,
macOS,
- Tizen,
Windows
}
```
@@ -91,8 +90,8 @@ It is also possible to pass the converter parameter:
-
+
```
@@ -112,7 +111,7 @@ 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(
@@ -120,7 +119,7 @@ class EnumToBoolConverterPage : ContentPage
new Binding(
static (ViewModel vm) => vm.SelectedPlatform,
converter: new EnumToBoolConverter(),
- converterParameter: MyDevicePlatform.Tizen));
+ converterParameter: MyDevicePlatform.Windows));
Content = new VerticalStackLayout
{
@@ -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)
}
};
}
diff --git a/docs/maui/converters/index.md b/docs/maui/converters/index.md
index 4954c948..b9dc0da9 100644
--- a/docs/maui/converters/index.md
+++ b/docs/maui/converters/index.md
@@ -2,7 +2,7 @@
title: Converters - .NET MAUI Community Toolkit
author: bijington
description: The .NET MAUI Community Toolkit provides a collection of pre-built, reusable converters to make developers lives easier.
-ms.date: 02/15/2024
+ms.date: 11/10/2026
---
# .NET MAUI Converters
@@ -11,6 +11,18 @@ ms.date: 02/15/2024
For further information on Converters please refer to the [.NET MAUI documentation](/dotnet/maui/fundamentals/data-binding/converters).
+## Converter culture
+
+A binding passes a culture to its converter. The culture is the `ConverterCulture` of the binding, or `CultureInfo.CurrentUICulture` when `ConverterCulture` isn't set. In .NET MAUI 11, `Binding` and `MultiBinding` both have a `ConverterCulture` property.
+
+The following example passes the `de-DE` culture to a converter:
+
+```xaml
+
+```
+
+The page of a converter that uses the culture describes how it uses it.
+
## .NET MAUI Community Toolkit Converters
The .NET MAUI Community Toolkit provides a collection of pre-built, reusable converters to make developers lives easier. Here are the converters provided by the toolkit:
diff --git a/docs/maui/converters/is-in-range-converter.md b/docs/maui/converters/is-in-range-converter.md
index 271fcc13..2bf4e6a9 100644
--- a/docs/maui/converters/is-in-range-converter.md
+++ b/docs/maui/converters/is-in-range-converter.md
@@ -2,7 +2,7 @@
title: IsInRangeConverter - .NET MAUI Community Toolkit
author: GeorgeLeithead
description: "The IsInRangeConverter is a one-way converter that takes an incoming value implementing IComparable, and a minimum and maximum value, and returns the result of the value being between the minimum and maximum values."
-ms.date: 11/26/2022
+ms.date: 11/10/2026
---
# IsInRangeConverter
@@ -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
diff --git a/docs/maui/converters/list-to-string-converter.md b/docs/maui/converters/list-to-string-converter.md
index 4b4de874..90bb6599 100644
--- a/docs/maui/converters/list-to-string-converter.md
+++ b/docs/maui/converters/list-to-string-converter.md
@@ -2,7 +2,7 @@
title: ListToStringConverter - .NET MAUI Community Toolkit
author: bijington
description: "The ListToStringConverter is a one way converter that returns a concatenation of the members of a collection, using the specified separator between each member."
-ms.date: 03/30/2022
+ms.date: 11/10/2026
---
# ListToStringConverter
@@ -22,6 +22,10 @@ The `ConvertBack` method is not supported. For the opposite behavior see the [`S
[!INCLUDE [common converter properties](../includes/communitytoolkit-converter.md)]
+## Culture
+
+The converter formats the items that implement `IFormattable`, such as numbers and dates, with the binding's culture. It calls `ToString()` on all other items.
+
## Syntax
### XAML
diff --git a/docs/maui/converters/math-expression-converter.md b/docs/maui/converters/math-expression-converter.md
index 74fe6230..0498c8a1 100644
--- a/docs/maui/converters/math-expression-converter.md
+++ b/docs/maui/converters/math-expression-converter.md
@@ -2,7 +2,7 @@
title: MathExpressionConverter - .NET MAUI Community Toolkit
author: VladislavAntonyuk
description: "The MathExpressionConverter is a converter that allows users to perform various math operations."
-ms.date: 05/16/2022
+ms.date: 11/10/2026
---
# MathExpressionConverter
@@ -15,6 +15,14 @@ The value that is passed in to the converter will be named `x`. In order to refe
[!INCLUDE [common converter properties](../includes/communitytoolkit-converter.md)]
+## Culture
+
+The expression syntax doesn't depend on the culture. Numbers in the expression always use `.` as the decimal separator, and function and constant names are case-insensitive in every culture, so `IF` and `PI` also work in Turkish.
+
+String inputs are parsed with the culture passed to the converter, the binding's `ConverterCulture`, which defaults to `CultureInfo.CurrentUICulture`. Under `tr-TR` or `de-DE`, the string `"3.5"` is read as `35`, because `.` is the group separator. A quoted string in the expression, and the `str()` and `len()` functions, use that culture too.
+
+Bind numbers as numbers, or set `ConverterCulture` to `CultureInfo.InvariantCulture` when the text is invariant.
+
## Syntax
The following examples show how to add a `Label` that will show the result of `x / 2` where `x` will have the value of `MyValue`.
diff --git a/docs/maui/converters/multi-math-expression-converter.md b/docs/maui/converters/multi-math-expression-converter.md
index bd6e4183..b6b25c5d 100644
--- a/docs/maui/converters/multi-math-expression-converter.md
+++ b/docs/maui/converters/multi-math-expression-converter.md
@@ -2,7 +2,7 @@
title: MultiMathExpressionConverter - .NET MAUI Community Toolkit
author: VladislavAntonyuk
description: "The MultiMathExpressionConverter is a converter for multiple math expressions."
-ms.date: 05/16/2022
+ms.date: 11/10/2026
---
# MultiMathExpressionConverter
@@ -22,6 +22,14 @@ The values that are passed in to the converter will be named `x?` where ? is the
```
+## Culture
+
+The expression syntax doesn't depend on the culture. Numbers in the expression always use `.` as the decimal separator, and function and constant names are case-insensitive in every culture, so `IF` and `PI` also work in Turkish.
+
+String inputs are parsed with the culture passed to the converter, the `MultiBinding`'s `ConverterCulture`, which defaults to `CultureInfo.CurrentUICulture`. Under `tr-TR` or `de-DE`, the string `"3.5"` is read as `35`, because `.` is the group separator. A quoted string in the expression, and the `str()` and `len()` functions, use that culture too.
+
+Bind numbers as numbers, or set `ConverterCulture` to `CultureInfo.InvariantCulture` when the text is invariant.
+
## Syntax
The following examples show how to add a `Label` that will show the result of `x0 + x1 + x2` where the `x` values will be supplied in the order of the `MultiBinding` definitions.
diff --git a/docs/maui/converters/text-case-converter.md b/docs/maui/converters/text-case-converter.md
index f5bcb5aa..4e84fccd 100644
--- a/docs/maui/converters/text-case-converter.md
+++ b/docs/maui/converters/text-case-converter.md
@@ -2,7 +2,7 @@
title: TextCaseConverter - .NET MAUI Community Toolkit
author: bijington
description: "The TextCaseConverter is a one way converter that allows users to convert the casing of an incoming string type binding."
-ms.date: 03/02/2022
+ms.date: 11/10/2026
---
# TextCaseConverter
@@ -19,6 +19,42 @@ The `ConvertBack` method is not supported.
[!INCLUDE [common converter properties](../includes/communitytoolkit-converter.md)]
+## Culture
+
+In .NET 11, the converter changes the case with the casing rules of the culture that .NET MAUI passes to it: the binding's `ConverterCulture`, which defaults to `CultureInfo.CurrentUICulture`. Only the letter I differs between cultures, in Turkish and Azerbaijani. For example, `Upper` converts `i` to `İ` in `tr-TR`, so `edit` becomes `EDİT` when the UI culture is Turkish.
+
+To keep ASCII casing, set `ConverterCulture` to `CultureInfo.InvariantCulture`:
+
+```xaml
+
+
+
+
+
+
+
+
+
+```
+
+The same in C#:
+
+```csharp
+label.SetBinding(
+ Label.TextProperty,
+ new Binding(nameof(ViewModel.MyValue), converter: new TextCaseConverter { Type = TextCaseType.Upper })
+ {
+ ConverterCulture = CultureInfo.InvariantCulture
+ });
+```
+
+When code calls the converter directly without a culture (`null`), the invariant culture is used.
+
## Syntax
### XAML
diff --git a/docs/maui/essentials/badge.md b/docs/maui/essentials/badge.md
index aad3eb96..0696bb57 100644
--- a/docs/maui/essentials/badge.md
+++ b/docs/maui/essentials/badge.md
@@ -2,7 +2,7 @@
title: Badge - .NET MAUI Community Toolkit
author: VladislavAntonyuk
description: The Badge API allows developers to set the app icon badge number on the home screen.
-ms.date: 11/05/2026
+ms.date: 11/10/2026
---
# Badge
@@ -26,14 +26,6 @@ Authorize Badge permission for the app. It is automatically requested.
Windows shows a badge only for an app with package identity, which is a packaged app. An unpackaged app, which is the default of the .NET MAUI template (`None`), doesn't show a badge: `SetCount` writes a line to the trace output and does nothing else. To show a badge, package the app by setting `WindowsPackageType` to `MSIX` in the project file.
-# [Tizen](#tab/tizen)
-
-Add permissions to `tizen-manifest.xml`:
-
-```xml
-http://tizen.org/privilege/notification
-```
-
---
## Syntax
diff --git a/docs/maui/essentials/index.md b/docs/maui/essentials/index.md
index 2bf47c77..b0cfac0b 100644
--- a/docs/maui/essentials/index.md
+++ b/docs/maui/essentials/index.md
@@ -2,12 +2,12 @@
title: Essentials - .NET MAUI Community Toolkit
author: jfversluis
description: The .NET MAUI Community Toolkit Essentials provides developers with cross-platform APIs for their applications.
-ms.date: 08/09/2023
+ms.date: 11/10/2026
---
# Essentials
-Android, iOS, MacCatalyst, Windows, and Tizen offer unique operating system and platform APIs that developers have access to all in C# leveraging .NET. Essentials provides a single cross-platform API that works with any .NET MAUI application that can be accessed from shared code no matter how the user interface is created.
+Android, iOS, MacCatalyst, and Windows offer unique operating system and platform APIs that developers have access to all in C# leveraging .NET. Essentials provides a single cross-platform API that works with any .NET MAUI application that can be accessed from shared code no matter how the user interface is created.
## .NET MAUI Community Toolkit Essentials
diff --git a/docs/maui/essentials/speech-to-text.md b/docs/maui/essentials/speech-to-text.md
index b0b629cc..6a2fb030 100644
--- a/docs/maui/essentials/speech-to-text.md
+++ b/docs/maui/essentials/speech-to-text.md
@@ -2,7 +2,7 @@
title: SpeechToText - .NET MAUI Community Toolkit
author: VladislavAntonyuk
description: The SpeechToText provides the ability to convert speech to text.
-ms.date: 05/26/2023
+ms.date: 11/10/2026
---
# SpeechToText
@@ -33,8 +33,6 @@ Add permissions to `Info.plist`
SpeechToText requires microphone usage
```
-For `OfflineSpeechToText`, iOS 13.0 or higher is required.
-
# [Windows](#tab/windows)
Add permissions to `Package.appxmanifest`
@@ -45,14 +43,6 @@ Add permissions to `Package.appxmanifest`
```
-# [Tizen](#tab/tizen)
-
-Add permissions to `tizen-manifest.xml`:
-
-```xml
-http://tizen.org/feature/microphone
-```
-
---
## Basic usage
diff --git a/docs/maui/get-started.md b/docs/maui/get-started.md
index 7f1543ce..87bbe5d1 100644
--- a/docs/maui/get-started.md
+++ b/docs/maui/get-started.md
@@ -2,7 +2,7 @@
title: Getting Started with the .NET Multi-platform App UI (.NET MAUI) Community Toolkit
author: bijington
description: The toolkit is available as a set of NuGet packages that can be added to any existing or new .NET MAUI project.
-ms.date: 11/05/2026
+ms.date: 11/10/2026
---
# Getting Started with the .NET Multi-platform App UI (.NET MAUI) Community Toolkit
@@ -77,61 +77,8 @@ To use the features of the toolkit please refer to the documentation pages for e
### [Maps](#tab/CommunityToolkitMauiMaps)
-This package enables you to display a map in your .NET MAUI Windows application.
-
> [!WARNING]
-> `CommunityToolkit.Maui.Maps` is deprecated and will be removed in a future release. Use .NET MAUI's own `Map` from the `Microsoft.Maui.Controls.Maps` package, which supports Windows starting with .NET MAUI 10. On Windows, it uses the WinUI 3 `MapControl`, which is backed by Azure Maps.
->
-> To move to it, remove the `CommunityToolkit.Maui.Maps` package and make sure your project references the `Microsoft.Maui.Controls.Maps` package directly, because `CommunityToolkit.Maui.Maps` referenced it for you. Remove `using CommunityToolkit.Maui.Maps;` and the call to `UseMauiCommunityToolkitMaps`, and call `UseMauiMaps` on every platform. On Windows, set your Azure Maps subscription key with `builder.ConfigureEssentials(essentials => essentials.UseMapServiceToken("YOUR_AZURE_MAPS_SUBSCRIPTION_KEY"))`. Without a valid key, the map shows no map data. For more information, see [Map](/dotnet/maui/user-interface/controls/map).
->
-> On Windows, the .NET MAUI `Map` doesn't support:
->
-> - `IsShowingUser`
-> - Polygons, polylines and circles in `MapElements`
-> - Pin labels and info windows
-> - The `MapClicked` event
->
-> It supports `MoveToRegion`, the `Street`, `Satellite` and `Hybrid` map types, traffic, scrolling, zooming and pins.
->
-> This library implements `Map` on Windows with Bing Maps for Enterprise, which Microsoft is retiring: free (Basic) accounts were retired on June 30, 2025, and Enterprise accounts can use it until June 30, 2028. For more information, see [Deprecate Map Control in favor of MAUI Map implementation](https://github.com/CommunityToolkit/Maui/issues/3190).
-
-**Package name:** `CommunityToolkit.Maui.Maps`
-
-**Package url:** https://www.nuget.org/packages/CommunityToolkit.Maui.Maps
-
-#### Initializing the package
-
-First the using statement needs to be added to the top of your *MauiProgram.cs* file
-
-```csharp
-using CommunityToolkit.Maui.Maps;
-```
-
-In order to use the `Map` correctly the `.UseMauiCommunityToolkitMaps` method must be called on the `MauiAppBuilder` class when bootstrapping an application the *MauiProgram.cs* file. This method expects a valid Bing Maps API key which you can obtain through the [Bing Maps Portal](https://www.bingmapsportal.com/).
-
-The following example shows how to perform this.
-
-```csharp
-var builder = MauiApp.CreateBuilder();
-builder
- .UseMauiApp()
- .UseMauiCommunityToolkitMaps("YOUR_API_KEY")
-```
-
-When using the .NET MAUI Community Toolkit Map for Windows and the regular .NET MAUI Maps together, you will need to make sure that each initialization call is only made for the relevant platform. The following example shows how to do this.
-
-```csharp
-var builder = MauiApp.CreateBuilder();
-builder
- .UseMauiApp()
-#if ANDROID || IOS
- .UseMauiMaps()
-#elif WINDOWS
- .UseMauiCommunityToolkitMaps("YOUR_API_KEY")
-#endif
-```
-
-For more information on how to initialize the map on iOS and Android, as well as how to work with the map control API, see the [.NET MAUI Maps documentation](/dotnet/maui/user-interface/controls/map).
+> `CommunityToolkit.Maui.Maps` was deprecated in the toolkit's last .NET 10 release and is removed in the .NET 11 release. The package has no .NET 11 version. Use .NET MAUI's own `Map` from the `Microsoft.Maui.Controls.Maps` package instead. For the steps to move to it, see [Map](views/Map.md).
### [MediaElement](#tab/CommunityToolkitMauiMediaElement)
diff --git a/docs/maui/index.md b/docs/maui/index.md
index d4b43f55..f9531244 100644
--- a/docs/maui/index.md
+++ b/docs/maui/index.md
@@ -2,7 +2,7 @@
title: .NET MAUI Community Toolkit documentation
author: bijington
description: The .NET MAUI Community Toolkit is a collection of reusable elements for application development with .NET MAUI, including animations, behaviors, converters, effects, and helpers.
-ms.date: 11/05/2026
+ms.date: 11/10/2026
---
# .NET Multi-platform App UI (.NET MAUI) Community Toolkit documentation
@@ -21,10 +21,12 @@ Feel free to browse the documentation using the table of contents on the left si
The .NET MAUI Community Toolkit supports the platforms officially supported by [Microsoft](/dotnet/maui/supported-platforms):
-* Android 5.0 (API 21) or higher. [MediaElement](views/MediaElement.md) requires Android 8.0 (API 26) or higher.
-* iOS 15.0 or higher is required.
-* macOS 12.0 or higher, using Mac Catalyst (15.0).
-* Windows 11 and Windows 10 version 1809 or higher, using [Windows UI Library (WinUI) 3](/windows/apps/winui/winui3/).
+* Android 7.0 (API 24) or higher. [MediaElement](views/MediaElement.md) requires Android 8.0 (API 26) or higher.
+* iOS 15.0 or higher.
+* macOS 14 or higher, using Mac Catalyst 17.0.
+* Windows 10 version 1809 (10.0.17763) or higher, using [Windows UI Library (WinUI) 3](/windows/apps/winui/winui3/).
+
+These versions match the minimum versions of .NET MAUI 11.
## [Get started][get-started]
diff --git a/docs/maui/views/Map.md b/docs/maui/views/Map.md
index 4bb76035..224dac81 100644
--- a/docs/maui/views/Map.md
+++ b/docs/maui/views/Map.md
@@ -1,59 +1,43 @@
---
-title: Map - .NET MAUI Community Toolkit
+title: Map (Removed) - .NET MAUI Community Toolkit
author: jfversluis
-description: "The Map control is a cross-platform view for displaying and annotating maps. The .NET MAUI Community Toolkit provides a Windows implementation that uses Bing Maps."
-ms.date: 11/05/2026
+description: "CommunityToolkit.Maui.Maps was removed in the .NET 11 release. Use the Map control from Microsoft.Maui.Controls.Maps instead."
+ms.date: 11/10/2026
---
-# Map
-
-The `Map` control is a cross-platform view for displaying and annotating maps. The .NET MAUI Community Toolkit provides a Windows implementation that uses Bing Maps.
+# Map (Removed)
> [!WARNING]
-> `CommunityToolkit.Maui.Maps` is deprecated and will be removed in a future release. Use .NET MAUI's own `Map` from the `Microsoft.Maui.Controls.Maps` package, which supports Windows starting with .NET MAUI 10. On Windows, it uses the WinUI 3 `MapControl`, which is backed by Azure Maps.
->
-> To move to it, remove the `CommunityToolkit.Maui.Maps` package and make sure your project references the `Microsoft.Maui.Controls.Maps` package directly, because `CommunityToolkit.Maui.Maps` referenced it for you. Remove `using CommunityToolkit.Maui.Maps;` and the call to `UseMauiCommunityToolkitMaps`, and call `UseMauiMaps` on every platform. On Windows, set your Azure Maps subscription key with `builder.ConfigureEssentials(essentials => essentials.UseMapServiceToken("YOUR_AZURE_MAPS_SUBSCRIPTION_KEY"))`. Without a valid key, the map shows no map data. For more information, see [Map](/dotnet/maui/user-interface/controls/map).
->
-> On Windows, the .NET MAUI `Map` doesn't support:
->
-> - `IsShowingUser`
-> - Polygons, polylines and circles in `MapElements`
-> - Pin labels and info windows
-> - The `MapClicked` event
->
-> It supports `MoveToRegion`, the `Street`, `Satellite` and `Hybrid` map types, traffic, scrolling, zooming and pins.
->
-> This library implements `Map` on Windows with Bing Maps for Enterprise, which Microsoft is retiring: free (Basic) accounts were retired on June 30, 2025, and Enterprise accounts can use it until June 30, 2028. For more information, see [Deprecate Map Control in favor of MAUI Map implementation](https://github.com/CommunityToolkit/Maui/issues/3190).
-
-## Setup
-
-Before you are able to use `Map` inside your application you will need to install the NuGet package and add an initialization line in your *MauiProgram.cs*. For more information on how to do this, please refer to the [Get Started](../get-started.md) page.
-
-## Usage
-
-The API of the .NET MAUI Community Toolkit implementation for Windows is not different from the API of the .NET MAUI Maps implementation for iOS and Android.
-
-For details on how to work with this map control, please refer to the [.NET MAUI Map documentation](/dotnet/maui/user-interface/controls/map).
+> `CommunityToolkit.Maui.Maps` was deprecated in the toolkit's last .NET 10 release and is removed in the .NET 11 release. The package has no .NET 11 version. The `Map` control for Windows that it provided used Bing Maps for Enterprise, which Microsoft is retiring. For more information, see [Deprecate Map Control in favor of MAUI Map implementation](https://github.com/CommunityToolkit/Maui/issues/3190).
-## Map types
+.NET MAUI includes its own `Map` control in the `Microsoft.Maui.Controls.Maps` package. It supports Android, iOS, Mac Catalyst, and Windows. On Windows, it uses the WinUI 3 `MapControl`, which is backed by Azure Maps. For details on how to work with the control, see the [.NET MAUI Map documentation](/dotnet/maui/user-interface/controls/map).
-The `MapType` of the map decides what the Windows map shows, as it does on iOS and Android:
+## Migrate to the .NET MAUI Map
-|MapType |Windows shows |
-|---------|---------|
-| `Street` | The road map. |
-| `Satellite` | Aerial imagery without place or road labels. |
-| `Hybrid` | Aerial imagery with labels. |
+1. Remove the `CommunityToolkit.Maui.Maps` package from your project.
+1. Add the `Microsoft.Maui.Controls.Maps` package to your project. `CommunityToolkit.Maui.Maps` referenced it for you, so your project might not reference it directly yet.
+1. Remove `using CommunityToolkit.Maui.Maps;` and the call to `UseMauiCommunityToolkitMaps` from *MauiProgram.cs*.
+1. Call `UseMauiMaps` on the `MauiAppBuilder` for every platform.
+1. On Windows, set your Azure Maps subscription key. Without a valid key, the map shows no map data.
-A value outside of the `MapType` enumeration shows the road map.
+```csharp
+var builder = MauiApp.CreateBuilder();
+builder
+ .UseMauiApp()
+ .UseMauiMaps();
-> [!NOTE]
-> Earlier versions showed the labels for `Satellite` too, so it looked the same as `Hybrid`. If your app chose `Satellite` on Windows to get labels, choose `Hybrid`.
+#if WINDOWS
+builder.ConfigureEssentials(essentials => essentials.UseMapServiceToken("YOUR_AZURE_MAPS_SUBSCRIPTION_KEY"));
+#endif
+```
-## Examples
+## Windows limitations
-You can find examples of this control in action in the [.NET MAUI Community Toolkit Sample Application](https://github.com/CommunityToolkit/Maui/tree/main/samples/CommunityToolkit.Maui.Sample/Pages/Views/Maps).
+On Windows, the .NET MAUI `Map` doesn't support:
-## API
+- `IsShowingUser`
+- Polygons, polylines and circles in `MapElements`
+- Pin labels and info windows
+- The `MapClicked` event
-You can find the source code for `Map` over on the [.NET MAUI Community Toolkit GitHub repository](https://github.com/CommunityToolkit/Maui/blob/main/src/CommunityToolkit.Maui.Maps/AppBuilderExtensions.shared.cs).
+It supports `MoveToRegion`, the `Street`, `Satellite` and `Hybrid` map types, traffic, scrolling, zooming and pins.
diff --git a/docs/maui/views/index.md b/docs/maui/views/index.md
index b490838f..5fc69cf5 100644
--- a/docs/maui/views/index.md
+++ b/docs/maui/views/index.md
@@ -2,7 +2,7 @@
title: Views - .NET MAUI Community Toolkit
author: jfversluis
description: The .NET MAUI Community Toolkit extends .NET MAUI controls.
-ms.date: 06/13/2023
+ms.date: 11/10/2026
---
# Views
@@ -24,7 +24,7 @@ The .NET MAUI Community Toolkit provides a collection of pre-built, reusable vie
| [`DrawingView`](DrawingView.md) | The `DrawingView` provides a surface that allows for the drawing of lines through the use of touch or mouse interaction. The result of a users drawing can be saved out as an image. |
| [`Expander`](Expander.md) | The `Expander` control provides an expandable container to host any content. |
| [`LazyView`](LazyView.md) | The `LazyView` control allows you to delay the initialization of a View.|
-| [`Map (Windows)`](Map.md) | The `Map` control is a cross-platform view for displaying and annotating maps. The Windows implementation is available through the .NET MAUI Community Toolkit. |
+| [`Map (Removed)`](Map.md) | The Windows `Map` implementation was removed in the .NET 11 release. Use the `Map` control from .NET MAUI instead. |
| [`MediaElement`](MediaElement.md) | The `MediaElement` is a view for playing multimedia such as audio and video. |
| [`Popup`](Popup.md) | The `Popup` view allows developers to build their own custom UI and present it to their users. |
| [`RatingView`](RatingView.md) | The `RatingView` is an ItemTemplate designed to provide developers with a flexible and customizable rating mechanism, similar to those used on popular review and feedback platforms. |
diff --git a/docs/maui/views/semantic-order-view.md b/docs/maui/views/semantic-order-view.md
index 52b1a31d..6cdb6a73 100644
--- a/docs/maui/views/semantic-order-view.md
+++ b/docs/maui/views/semantic-order-view.md
@@ -2,7 +2,7 @@
title: SemanticOrderView - .NET MAUI Community Toolkit
author: bijington
description: The SemanticOrderView provides the ability to control the order of VisualElements for screen readers on Android, iOS and Mac Catalyst, and the keyboard Tab order on Windows, to improve the Accessibility of an application.
-ms.date: 11/07/2026
+ms.date: 11/10/2026
---
# SemanticOrderView
@@ -61,7 +61,7 @@ The views that aren't in `ViewOrder` stay accessible on every platform.
|Platform |Behavior |
|---------|---------|
| iOS and Mac Catalyst | The views of `ViewOrder` are the first accessibility elements of the `SemanticOrderView`, in that order. Assistive technologies visit the other views after them, in the order of the view hierarchy. |
-| Android | On Android 5.1 (API 22) or later, the order of `ViewOrder` determines how TalkBack traverses the views. On earlier versions the order isn't applied, and a message is written to the trace output. |
+| Android | The order of `ViewOrder` determines how TalkBack traverses the views. |
| Windows | `ViewOrder` sets the keyboard Tab order of the views. It doesn't change the order in which Narrator reads them, which follows the visual tree. Only views that can take the keyboard focus, such as a `Button` or an `Entry`, are Tab stops, so ordering `Label` views, as in the example above, has no effect on Windows. |
On Windows, the views of `ViewOrder` that the `SemanticOrderView` holds come first among the Tab stops of the `SemanticOrderView`, in the order of `ViewOrder`, followed by the rest of its content in the order of the visual tree. The Tab key reaches the controls above the `SemanticOrderView` before these views, and the controls below it after them. A view of `ViewOrder` that is inside a control within the `SemanticOrderView`, such as a `ScrollView`, or outside of the `SemanticOrderView`, gets a `TabIndex` instead. That `TabIndex` orders it among the Tab stops of the nearest control that holds it.