Microsoft.Maui.Controls.Compatibility

Releases

1. ▸▾10.0.6029 Apr 2026Deprecated

   Replace deprecated NetworkReachability with NWPathMonitor on iOS/macOS by @jfversluis via @Copilot in #32354 🔧 Fixes

   What's Changed

   .NET MAUI 10.0.60 introduces significant improvements across all platforms with focus on quality, performance, and developer experience. This release includes 242 commits with various improvements, bug fixes, and enhancements.

   Ai Agents

   • Add eval.yaml for verify-tests-fail-without-fix skill by @PureWeen in #34815

   Blazor

   • [blazorwebview] align SupportedOSPlatform attribute with templates by @jonathanpeppers in #25073

   Border

   • [Testing] Refactoring Feature Matrix UITest Cases for Border Control by @HarishKumarSF4517 in #34349

   • Fix LayoutCycleException from nested Borders on Windows by @Oxymoron290 in #34337

     🔧 Fixes
     • LayoutCycleException caused by nested Borders in ControlTemplates

   Button

   • [iOS] Button RTL text and image overlap - fix by @kubaflo in #29041

   • [Android] Button with corner radius shadow broken on Android device - fix by @kubaflo in #29339

     🔧 Fixes
     • [Android] Button with corner radius shadow broken on Android device

   • [iOS] Preserve AlwaysTemplate rendering mode in Button.ResizeImageIfNecessary by @kubaflo in #25107

     🔧 Fixes
     • [iOS] TintColor on UIButton image no longer working when button made visible

   • [Android] Implemented Material3 support for ImageButton by @Dhivya-SF4094 in #33649

     🔧 Fixes
     • Implement Material3 support for ImageButton

   • Fixed CI failure : Restore BackButtonBehavior IsEnabled after CanExecute changes by @Shalini-Ashokan in #34668

   Checkbox

   • [iOS/MacCatalyst] Fix CheckBox foreground color not resetting when set to null by @Ahamed-Ali in #34284

     🔧 Fixes
     • [iOS] Color of the checkBox control is not properly worked on dynamic scenarios

   CollectionView

   • [Android] Fix CollectionView selection crash with HeaderTemplate by @NirmalKumarYuvaraj in #34275

     🔧 Fixes
     • [Bug] [Android] System.ArgumentOutOfRangeException: Index was out of range. Must be non-negative and less than the size of the collection. Parameter name: index

   • [Windows] Fixed CollectionView with grouping fails to add items when a footer template is present or crashes when removing data. by @NirmalKumarYuvaraj in #24867

   🔧 Fixes

   • [Windows] CollectionView with grouping fails to add items when a footer template is present or crashes when removing data.
   • [Windows] CollectionView Not Updating Correctly When Adding Items or Groups
   • Using CollectionView IsGrouped="True" bound to ObservableCollection causes crash
   • .net 8 CollectionView Group Add method issue

   • [iOS] Label LinebreakMode (TailTruncation) for FormattedText does't work in CollectionView after scroll - fix by @kubaflo in #28151

     🔧 Fixes
     • [iOS] Label LinebreakMode (TailTruncation) for FormattedText does't work in CollectionView after scroll

   • [iOS] Fix CollectionView excessive height when ObservableCollection source loads with delay by @Vignesh-SF3580 in #34424

     🔧 Fixes
     • [iOS] CollectionView has excessive height if ObservableCollection source delayed in loading

   • [Android] Fix CollectionView sizing when wrapped in RefreshView by @Dhivya-SF4094 in #34387

     🔧 Fixes
     • Refreshview - Collectionview sizing not working correctly

   • [iOS] Fix CollectionView horizontal scroll when empty inside RefreshView by @praveenkumarkarunanithi in #34382

     🔧 Fixes
     • CollectionView is scrolling left/right when the collection is empty and inside a RefreshView

   • [iOS/Mac] CollectionView: Fix incorrect ItemsViewScrolledEventArgs indices with grouped items by @SyedAbdulAzeemSF4852 in #34240

     🔧 Fixes
     • [iOS/Mac/Windows] CollectionView ItemsViewScrolledEventArgs are incorrect when IsGrouped = true

   • [iOS] Fix for CollectionView.Measure() returning incorrect height when called before the view is mounted by @BagavathiPerumal in #34331

     🔧 Fixes
     • CollectionView messes up Measure operation on Views

   • [Android] Fix for CollectionView EmptyView swaps reusing stale RecyclerView item holders by @BagavathiPerumal in #34452

     🔧 Fixes
     • I5_EmptyView_Swap - Continuously turning the "Toggle EmptyViews" on and off would cause an item from the list to show up

   • [Android, iOS] Fix for ContentView not clearing its Background when set to null by @SyedAbdulAzeemSF4852 in #31340

     🔧 Fixes
     • Custom selection styles for items in CollectionView are ignored when programmatically selecting an item

   • [Android] Fix for Android TalkBack announcing CollectionView items as clickable when SelectionMode is None by @praveenkumarkarunanithi in #31516

     🔧 Fixes
     • Android TalkBack screen reader always reads CollectionView elements as clickable

   • [iOS] Fix indicator dots not rendering when using indicator size with shadow by @Shalini-Ashokan in #31463

     🔧 Fixes
     • [iOS, Catalyst] IndicatorView – Applying IndicatorSize with Shadow causes some indicators to be invisible

   • [Android] Fix for ArgumentOutOfRangeException thrown by ScrollTo when an invalid group index is specified by @SyedAbdulAzeemSF4852 in #31553

     🔧 Fixes
     • [Android] ArgumentOutOfRangeException thrown by ScrollTo when group index is invalid

   • [Android] - Fix Inconsistent Footer Scrolling Behaviour in CollectionView with EmptyView by @prakashKannanSf3972 in #28107

     🔧 Fixes
     • CollectionView Footer Becomes Scrollable When EmptyView is Active on Android

   • [Android] CollectionView: Defer RemainingItemsThresholdReached to avoid RecyclerView scroll callback warnings by @NirmalKumarYuvaraj in #30907

     🔧 Fixes
     • Android: CollectionView's ScrollTo() triggers Android warnings
     • CollectionView throws java.lang.IllegalStateException on Android when using RemainingItemsThresholdReachedCommand

   • [iOS] Fix incorrect FirstVisibleItemIndex reported by CollectionView.Scrolled after programmatic scroll by @Shalini-Ashokan in #33719

     🔧 Fixes
     • [iOS, Mac] CollectionView Scrolled event reports incorrect FirstVisibleItemIndex after programmatic ScrollTo

   • [Android] CarouselView incorrectly reads out "double tap to activate" - fix by @kubaflo in #31418

     🔧 Fixes
     • [Android] CarouselView incorrectly reads out "double tap to activate"

   • IndicatorView: Fix MaximumVisible not respected when using custom IndicatorTemplate by @SyedAbdulAzeemSF4852 in #31469

     🔧 Fixes
     • IndicatorView.MaximumVisible not respected when IndicatorTemplate is applied

   • [iOS] Fix for CarouselView remains interactive when disabled by @SyedAbdulAzeemSF4852 in #32794

     🔧 Fixes
     • [Android, iOS] CollectionView and CarouselView remain interactive when disabled

   • [Android/iOS] Fix CollectionView not respecting SafeAreaEdges settings by @praveenkumarkarunanithi in #33908

     🔧 Fixes
     • CollectionView does not respect content SafeAreaEdges choices (Regression for Android, different problem in iOS)

   • [Testing] Additional Feature Matrix Test Cases for CollectionView - 2 by @TamilarasanSF4853 in #33632

   • [Android, Windows] Fix CollectionView handler cleanup when DataTemplateSelector switches templates by @Vignesh-SF3580 in #34534

     🔧 Fixes
     • [CV][Android] fails to disconnect handlers when items are removed or DataTemplateSelector switches templates

   • [iOS, Mac] Fix exponential event handler accumulation in CollectionViewHandler2 causing SnapPoints freeze by @Vignesh-SF3580 in #34493

     🔧 Fixes
     • [MAUI]I9_Scrolling-snap points: After selecting one of these two lists and clicking the 'Done' button, it will take a long time (about 20 seconds) to execute the action

   • [Android] Fixed CollectionView MeasureFirstItem ItemSizingStrategy Not Applied in Horizontal Layouts by @NanthiniMahalingam in #29474

     🔧 Fixes
     • [Android] CollectionView with ItemSizingStrategy="MeasureFirstItem" Does Not Work as Expected for HorizontalList and HorizontalGrid Layouts

   • Fixed - Grouped CollectionView items not rendered properly on Android, works on Windows by @KarthikRajaKalaimani in #27847

     🔧 Fixes
     • Grouped CollectionView items not rendered properly on Android, works on Windows
     • [Android] ItemSizingStrategy="MeasureFirstItem" does not work correctly with VerticalGrid and grouped ItemsSource
     • Grouped CollectionView doesnt size correctly when ItemSizingStrategy="MeasureFirstItem"

   • [Windows] Fixed Horizontal Spacing for Horizontal List by @SubhikshaSf4851 in #28311

   • [Windows, MAC] - Fix Selected State Not Being Retained in CollectionView Items When PointerOver Is Applied by @prakashKannanSf3972 in #29815

     🔧 Fixes
     • CollectionView Selected state does not work on the selected item when combined with PointerOver.

   • Fix CollectionView grid spacing updates for first row and column by @KarthikRajaKalaimani in #34527

     🔧 Fixes
     • [MAUI] I2_Vertical grid for horizontal Item Spacing and Vertical Item Spacing - horizontally updating the spacing only applies to the second column

   • [Android] ItemsUpdatingScrollMode in CarouselView by @kubaflo in #30106

     🔧 Fixes
     • [Android] ItemsUpdatingScrollMode in CarouselView Not Working as expected

   • [Windows] Fix image shift in CarouselView when resizing the window by @Vignesh-SF3580 in #33959

     🔧 Fixes
     • Image shifts downward when window is resized smaller

   • [Windows] Fixed CollectionView throws NRE when value of IsGrouped property is changed to false by @NirmalKumarYuvaraj in #27331

     🔧 Fixes
     • [Windows] CollectionView throws NRE when value of IsGrouped property is changed to false
     • [Windows] NullReferenceException thrown When Toggling IsGrouped to True in ObservableCollection Binding

   • [Android] Fix the CarouselView ScrollTo issue in the candidate branch by @Ahamed-Ali in #34739

     🔧 Fixes
     • [Android] ItemsUpdatingScrollMode in CarouselView Not Working as expected

   • [iOS/MacCatalyst] Fix CollectionView cell misalignment regression on candidate branch by @praveenkumarkarunanithi in #34667

     🔧 Fixes
     • CollectionView does not respect content SafeAreaEdges choices (Regression for Android, different problem in iOS)
     • [MacOS] Misaligned items before resizing the window on MacOS
     • [.NET 10] Increasing gap in the bottom while scrolling.

   • [Android] Fix CollectionView LinearItemsLayout first/last items clipped when ItemSpacing changes at runtime and candidate tests failures by @Shalini-Ashokan in #34664

     🔧 Fixes
     • [MAUI] I2_Spacing_ItemSpacing - First and last item on the list is truncated after changing Spacing value.

   • [Android] Fix CollectionView dynamic item sizing reset after scroll by @Vignesh-SF3580 in #34882

     🔧 Fixes
     • [MAUI] I3_Sizing_Dynamic item sizing - After dragging the scrollbar, all images will automatically return to their original size.

   DateTimePicker

   • Android TimePicker ignores 24 hour system setting when using Format Property - fix by @kubaflo in #28797

     🔧 Fixes
     • Android TimePicker ignores 24 hour system setting when using Format Property

   • [Android] Implemented Material3 support for DatePicker by @Dhivya-SF4094 in #33651

     🔧 Fixes
     • Implement material3 support for DatePicker

   • [Windows] Fix for TimePicker rendering a default time when its value is null by @SyedAbdulAzeemSF4852 in #32314

     🔧 Fixes
     • Nullable support is not working properly on Windows TimePicker and macOS DatePicker and TImePicker

   • [Windows] Fix DatePicker CharacterSpacing Property Not Working by @devanathan-vaithiyanathan in #30495

     🔧 Fixes
     • [Windows] DatePicker CharacterSpacing Property Not Working on Windows

   Dialogalert

   • [Issue-Resolver] Fix alert dialogs not displaying after dismissing modal page on iOS by @kubaflo in #32872

     🔧 Fixes
     • Alert popup not displaying when dismissing modal page on iOS/MacOS

   Drawing

   • [iOS, Mac, Windows] GraphicsView: Fix Background/BackgroundColor not updating by @NirmalKumarYuvaraj in #31254

     🔧 Fixes
     • [iOS, Mac, Windows] GraphicsView does not change the Background/BackgroundColor

   • [iOS] GraphicsView DrawString - fix by @kubaflo in #26304

     🔧 Fixes
     • DrawString not rendering in iOS.
     • GraphicsView DrawString not rendering in iOS
     • DrawString doesn't work on maccatalyst

   • [Android] - Fix Shadow Rendering For Transparent Fill, Stroke (Lines), and Text on Shapes by @prakashKannanSf3972 in #29528

     🔧 Fixes
     • Ellipse Transparency Not Rendered When Drawing Arc Inside the Ellipse Using GraphicsView on Android

   • Revert "[iOS, Mac, Windows] GraphicsView: Fix Background/BackgroundColor not updating (#31254)" by @Ahamed-Ali via @Copilot in #34508

   • [Android] Fix GraphicsView dirtyRect mismatch when display density changes by @praveenkumarkarunanithi in #34416

     🔧 Fixes
     • Android display-size change causes parent and drawable children mismatch in .NET MAUI

   • [Android] Fix for Automatic Flow Direction change in Graphics View by @HarishwaranVijayakumar in #29392

     🔧 Fixes
     • Automatic Flow Direction Change for Arabic Strings in When Drawing the String in MAUI on Android and Opposite Behavior in Windows.

   • [iOS, Windows] GraphicsView: Fix GetStringSize() returning inaccurate text measurements by @Dhivya-SF4094 in #30133

     🔧 Fixes
     • [iOS] canvas.GetStringSize() is not consistent with actual string size in GraphicsView

   • [Android] Fix for Shadows disappearing permanently in Android after Label opacity is at any time set to "0" by @BagavathiPerumal in #30379

     🔧 Fixes
     • Shadows disappearing permanently in Android and Windows after Label opacity is at any time set to "0"

   Entry

   • [iOS] Fixed Entry with IsPassword toggling loses previously entered text by @SubhikshaSf4851 in #30572

     🔧 Fixes
     • Entry with IsPassword toggling loses previously entered text on iOS when IsPassword is re-enabled

   • [Android] Fixed SelectionLength Not Updated Correctly for Right-to-Left Text Selection on Editor and Entry by @Dhivya-SF4094 in #30906

     🔧 Fixes
     • SelectionLength in Entry and Editor behaves differently on Android and Windows if the user selected the text from right to left

   • [Android] Fix Java.Lang.IllegalArgumentException crash in Entry with StringFormat binding by @Vignesh-SF3580 in #34427

     🔧 Fixes
     • App crashes when entry bound to float value with fractional format

   • [Android] Implement material3 support for Entry by @HarishwaranVijayakumar in #33673

     🔧 Fixes
     • Implement Material3 support for Entry

   • [Windows] Fix Narrator announcing typed characters for password Entry by @Vignesh-SF3580 in #33600

     🔧 Fixes
     • Entry with IsPassword=true exposes entered text to screen readers (Windows Narrator)

   • SelectionLength property update when entry is focused - fix by @kubaflo in #26213

     🔧 Fixes
     • SelectionLength Property Not Applied to Entry at Runtime

   • Fixed Early casting in Entry bound to double for negative decimal input by @Dhivya-SF4094 in #30540

     🔧 Fixes
     • Entry bound to a double casts values too early, preventing small negative decimal entries

   • Revert "SelectionLength property update when entry is focused - fix (#26213)" by @Ahamed-Ali via @Copilot in #34753

   Essentials

   • Replace deprecated NetworkReachability with NWPathMonitor on iOS/macOS by @jfversluis via @Copilot in #32354

     🔧 Fixes
     • NetworkReachability is obsolete on iOS/maccatalyst 17.4+
     • Use NWPathMonitor on iOS for Essentials Connectivity

   • March 16th, Candidate by @PureWeen in #34437

     🔧 Fixes
     • Use NWPathMonitor on iOS for Essentials Connectivity
     • DrawString doesn't work on maccatalyst
     • GraphicsView DrawString not rendering in iOS
     • [Slider] MAUI Slider thumb image is big on android
     • Control's Loaded event invokes before calling its measure override method.
     • CollectionView on Android does not provide height, width, logical children once loaded, works fine on Windows
     • [iOS] [MacCatalyst] CollectionView renders large empty space at bottom of view
     • RadioButton: TextColor for plain Content not working on iOS
     • RadioButton disabled UI issue - iOS
     • Android Switch Control Thumb Shadow
     • Label with HTML TextType does not display images on Android
     • Keyboard focus does not shift to a newly opened modal page: Pressing enter clicks the button on the page beneath the modal page
     • App crashes when calling ItemsView.ScrollTo on unloaded CollectionView
     • SemanticProperties do not work on ToolbarItems
     • DrawString not rendering in iOS.
     • [MAUI] Select items traces are preserved
     • Flyout Items Not Displayed in RightToLeft FlowDirection on iOS in Landscape Orientation and Hamburger Icon Positioned Incorrectly
     • [iOS] SwipeView: SwipeItem.IconImageSource.FontImageSource color value not honored
     • OnAppearing and OnNavigatedTo does not work when using extended Tabbar (tabbar with more than 5 tabs) on IOS.
     • Shell.BackButtonBehavior does not work when using extended Tabbar (tabbar with more than 5 tabs)on IOS.
     • CollectionView CollectionViewHandler2 doesnt change ItemsLayout on DataTrigger
     • Android TimePicker ignores 24 hour system setting when using Format Property
     • [iOS] [ActivityIndicator] IsRunning ignores IsVisible when set to true
     • [iOS] Group Header/Footer Repeated for All Items When IsGrouped is True for ObservableCollection in CollectionView
     • Ellipse Transparency Not Rendered When Drawing Arc Inside the Ellipse Using GraphicsView on Android
     • System.NullReferenceException at NavigationRenderer.SetStatusBarStyle()
     • VoiceOver on Toolbar Item
     • [iOS] Flyout icon not replaced by back button when root page is changed using InsertPageBefore
     • Entry with IsPassword toggling loses previously entered text on iOS when IsPassword is re-enabled
     • Update the Android Connectivity implementation to user modern APIs
     • CollectionView not being able to remove selected item highlight on iOS
     • [iOS] TimePicker AM/PM frequently changes when the app is closed and reopened
     • Shell TabBar More button causes ViewModel command binding disconnection on back navigation
     • Content page onappearing not firing if tabs are on the more tab on IOS
     • [iOS, Mac, Windows] GraphicsView does not change the Background/BackgroundColor
     • iOS CollectionView doesn't respect a change to ItemsLayout when using Items2.CollectionViewHandler2
     • iOS 26 - The MaxLength property value is not respected on an Entry control.
     • NavigationPage TitleView iOS 26
     • NetworkReachability is obsolete on iOS/maccatalyst 17.4+
     • MediaPicker.PickPhotosAsync does not preserve image orientation
     • FilePicker PickMultipleAsync nullable reference type
     • [iOS/Mac] CollectionView2 EmptyView takes up large horizontal space even when the content is small
     • [MacOS 26] Text on picker options are not centered on macOS 26.1
     • .NET MAUI Entry Maximum Length not working on iOS and macOS
     • [Android] TabbedPage BottomNavigation BarBackgroundColor does not extend to system navigation bar area in Edge-to-Edge mode
     • Changing Shell Tab Visibility when navigating back multiple pages ignores Shell Tab Visibility
     • Runtime Scrollbar visibility not updating correctly on Android and macOS platforms.
     • Focus

   Note truncated.