diff --git a/docs/user-interface/controls/carouselview/index.md b/docs/user-interface/controls/carouselview/index.md index 299a8c00b..97d424d90 100644 --- a/docs/user-interface/controls/carouselview/index.md +++ b/docs/user-interface/controls/carouselview/index.md @@ -1,7 +1,7 @@ --- title: "CarouselView" description: "The .NET MAUI CarouselView is a view for presenting data in a scrollable layout, where users can swipe to move through a collection of items." -ms.date: 09/30/2024 +ms.date: 08/19/2025 --- # CarouselView @@ -17,3 +17,23 @@ By default, will display its items i By default, provides looped access to its collection of items. Therefore, swiping backwards from the first item in the collection will display the last item in the collection. Similarly, swiping forwards from the last item in the collection will return to the first item in the collection. shares much of its implementation with . However, the two controls have different use cases. is typically used to present lists of data of any length, whereas is typically used to highlight information in a list of limited length. For more information about , see [CollectionView](~/user-interface/controls/collectionview/index.md). + +::: moniker range=">=net-maui-10.0" + +> [!NOTE] +> On iOS and Mac Catalyst, the optimized handlers that were optional in .NET 9 are the default handlers for in .NET 10, providing improved performance and stability. + +## Revert to .NET 9 behavior + +We recommend using the new handler for , but if you would like to opt-out of this behavior and revert back to the .NET 9 handler, you can use the code below in your `MauiProgram.cs`. + +```csharp +#if IOS || MACCATALYST +builder.ConfigureMauiHandlers(handlers => +{ + handlers.AddHandler(); +}); +#endif +``` + +::: moniker-end diff --git a/docs/user-interface/controls/collectionview/index.md b/docs/user-interface/controls/collectionview/index.md index 58d80d1ce..dc93704c1 100644 --- a/docs/user-interface/controls/collectionview/index.md +++ b/docs/user-interface/controls/collectionview/index.md @@ -1,7 +1,7 @@ --- title: "CollectionView" description: "The .NET MAUI CollectionView displays a scrollable list of selectable data items, using different layout specifications." -ms.date: 08/30/2024 +ms.date: 08/19/2025 --- # CollectionView @@ -16,6 +16,26 @@ The following screenshot shows a t should be used for presenting lists of data that require scrolling or selection. A bindable layout can be used when the data to be displayed doesn't require scrolling or selection. For more information, see [BindableLayout](~/user-interface/layouts/bindablelayout.md). +::: moniker range=">=net-maui-10.0" + +> [!NOTE] +> On iOS and Mac Catalyst, the optimized handlers that were optional in .NET 9 are the default handlers for in .NET 10, providing improved performance and stability. + +## Revert to .NET 9 behavior + +We recommend using the new handler for , but if you want to opt-out of this behavior and revert back to the .NET 9 handler, you can use the code below in your `MauiProgram.cs`. + +```csharp +#if IOS || MACCATALYST +builder.ConfigureMauiHandlers(handlers => +{ + handlers.AddHandler(); +}); +#endif +``` + +::: moniker-end + ## CollectionView and ListView differences While the and APIs are similar, there are some notable differences: