[iOS] CollectionView as root element in ContentPage makes top item sticky

[drasticactions]

Description

Simulator.Screen.Recording.-.iPhone.16.Pro.-.2025-02-06.at.23.11.54.mp4

If you have a CollectionView as the root element on a page, and it has a DataTemplate that is nested in a another type like Grid or StackLayout, the top most cells contents will stay sticky at the top of the view when scrolling instead of going off screen.

If the Page is wrapped in another view (NavigationView, Shell), it doesn't happen.

I tried with CollectionViewHandler2 and it did the same thing.

I could not get it to reproduce in Catalyst.

It did work in iOS with .NET 8.

Steps to Reproduce

Run the sample

Link to public reproduction project repository

https://github.com/drasticactions/MauiRepoRedux/tree/collectionview-break

Version with bug

9.0.30 SR3

Is this a regression from previous behavior?

Yes, this used to work in .NET MAUI

Last version that worked well

8.0.100 SR10

Affected platforms

iOS

Affected platform versions

No response

Did you find any workaround?

Wrap the page in a NavigationPage or use Shell

Relevant log output

[kubaflo]

Hi! @drasticactions, I think the issue should be fixed when you add IgnoreSafeArea="True".

<CollectionView ItemsSource="{x:Static local:NamedColor.All}">
                <CollectionView.ItemTemplate>
                        <DataTemplate x:DataType="local:NamedColor">
                                <VerticalStackLayout IgnoreSafeArea="True">
                                        <Label Text="{Binding FriendlyName}"/>
                                </VerticalStackLayout>
                        </DataTemplate>
                </CollectionView.ItemTemplate>
</CollectionView>

If you want to use a safe area then add the lines below to your page

xmlns:ios="clr-namespace:Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific;assembly=Microsoft.Maui.Controls"
ios:Page.UseSafeArea="True"

I am only wondering if this is a bug or not. @PureWeen @rmarinho thoughts?

[jsuarezruiz]

Happens with CollectionViewHandler2?

[kubaflo]

Happens with CollectionViewHandler2?

It does

[kubaflo]

The issue seems to arise because we are not using Shell or NavigationPage/TabbedPage. As a result, all elements that inherit from Layout implicitly respect the safe area insets, sometimes leading to unexpected behavior.

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="Maui.Controls.Sample.MainPage"
             xmlns:local="clr-namespace:Maui.Controls.Sample">
             <Grid>
                <Label Text="Hello"/>
             </Grid>
</ContentPage>

[RoiChen001]

I can repro this issue at iOS platform on the latest 17.13.0 Preview 5.0(9.0.30 & 9.0.0 &8.0.100).