如何让MAUI ListView滚动至Header顶部或ContentPage顶部？

1. 滚动到ListView.Header顶部 #

如果需要让ListView滚动到Header的最顶端，不要调用滚动到列表项的重载，改用指定ScrollToPosition.Start的重载即可：

// 按钮点击事件处理
private void BackToTop_Clicked(object sender, EventArgs e)
{
    myListView.ScrollTo(null, ScrollToPosition.Start, animate: true);
}

这个调用会直接将ListView滚动到可视区域的最顶部，包含Header部分，而不是停留在第一项的位置。

2. 滚动到ContentPage顶部 #

如果目标是回到整个ContentPage的顶部，需要将页面的所有内容嵌套进ScrollView（如果原本布局不是这样的话），然后控制这个ScrollView滚动到顶部：

XAML布局示例 #

<ContentPage>
    <ScrollView x:Name="pageRootScrollView">
        <Grid>
            <!-- 你的ListView及其他页面内容 -->
            <ListView x:Name="myListView" 
                      Header="这是ListView头部"
                      ItemsSource="{Binding Items}">
                <!-- 定义ItemTemplate等 -->
            </ListView>
            
            <!-- 返回顶部按钮，定位在右下角 -->
            <Button Text="返回顶部"
                    HorizontalOptions="End"
                    VerticalOptions="End"
                    Margin="0,0,16,16"
                    Clicked="BackToTop_Clicked"/>
        </Grid>
    </ScrollView>
</ContentPage>

后台代码 #

private void BackToTop_Clicked(object sender, EventArgs e)
{
    pageRootScrollView.ScrollToAsync(0, 0, animate: true);
}

这种方式会让整个页面内容滚动到最顶端，完全满足回到ContentPage顶部的需求。

关于MAUI v8.0的相关功能 #

MAUI v8.0确实为ScrollView新增了更简洁的ScrollToTopAsync()方法，用法如下：

await pageRootScrollView.ScrollToTopAsync(animate: true);

不过该功能仅针对ScrollView，ListView本身并没有新增专门的返回顶部方法，你可以通过前面提到的ScrollTo(null, ScrollToPosition.Start, true)实现ListView自身的顶部滚动。

内容的提问来源于stack exchange，提问作者iaps