[NET10] CollectionView/CarouselView handers (#2995)

* docs(.NET10): Note that optimized handlers are default for CollectionView/CarouselView on iOS/Mac Catalyst in .NET 10; update ms.date

* Document reverting to .NET 9 behavior for CarouselView

Added instructions to revert to .NET 9 behavior for CarouselView.

* Document reverting to .NET 9 handler for CarouselView

Added instructions to revert to .NET 9 behavior for CarouselView in MauiProgram.cs.

* Clarify handler recommendation for CollectionView

Updated the recommendation to use the new handler for CollectionView instead of CarouselView.

---------

Co-authored-by: Gerald Versluis <[email protected]>

Author: davidortinau

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, <xref:Microsoft.Maui.Controls.CarouselView> will display its items i
 By default, <xref:Microsoft.Maui.Controls.CarouselView> 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.
 
 <xref:Microsoft.Maui.Controls.CarouselView> shares much of its implementation with <xref:Microsoft.Maui.Controls.CollectionView>. However, the two controls have different use cases. <xref:Microsoft.Maui.Controls.CollectionView> is typically used to present lists of data of any length, whereas <xref:Microsoft.Maui.Controls.CarouselView> is typically used to highlight information in a list of limited length. For more information about <xref:Microsoft.Maui.Controls.CollectionView>, 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 <xref:Microsoft.Maui.Controls.CarouselView> in .NET 10, providing improved performance and stability.
+
+## Revert to .NET 9 behavior
+
+We recommend using the new handler for <xref:Microsoft.Maui.Controls.CarouselView>, 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<Microsoft.Maui.Controls.CarouselView, Microsoft.Maui.Controls.Handlers.Items.CarouselViewHandler>();
+});
+#endif
+```
+
+::: moniker-end

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 <xref:Microsoft.Maui.Controls.CollectionView> t
 
 <xref:Microsoft.Maui.Controls.CollectionView> 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 <xref:Microsoft.Maui.Controls.CollectionView> in .NET 10, providing improved performance and stability.
+
+## Revert to .NET 9 behavior
+
+We recommend using the new handler for <xref:Microsoft.Maui.Controls.CollectionView>, 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<Microsoft.Maui.Controls.CollectionView, Microsoft.Maui.Controls.Handlers.Items.CollectionViewHandler>();
+});
+#endif
+```
+
+::: moniker-end
+
 ## CollectionView and ListView differences
 
 While the <xref:Microsoft.Maui.Controls.CollectionView> and <xref:Microsoft.Maui.Controls.ListView> APIs are similar, there are some notable differences: