You need to enable JavaScript to run this app. Xamarin Forms中滚动内容时如何折叠(隐藏/上滑)导航栏(标题栏)?
优惠活动
大模型
产品
解决方案
定价
更多

Xamarin Forms中滚动内容时如何折叠(隐藏/上滑)导航栏(标题栏)?

实现方案

方案1:简单快速实现(基于系统导航栏)

该方案实现成本低,直接调用系统API控制导航栏显示隐藏,缺点是切换无过渡动画,效果比较生硬。

修改后XAML代码

<ContentPage ...
             NavigationPage.HasNavigationBar="True"
             Title="Home">
    <ContentPage.Content>
        <!-- 给ListView增加名称标识,注册滚动事件 -->
        <ListView x:Name="MainListView"
                  VerticalOptions="FillAndExpand" 
                  HasUnevenRows="True" 
                  CachingStrategy="RecycleElement"
                  ItemsSource="{Binding ListItems}" 
                  SeparatorVisibility="None"
                  Scrolled="OnListViewScrolled">
            <ListView.ItemTemplate>
                <DataTemplate>
                    <ViewCell>
                        <StackLayout>
                            <Label />
                        </StackLayout>
                    </ViewCell>
                </DataTemplate>
            </ListView.ItemTemplate>
        </ListView>
    </ContentPage.Content>
</ContentPage>

后台逻辑代码

// 记录上次滚动的Y轴偏移量
private double _lastScrollY;
// 滚动阈值,避免微小滚动误触发切换
private const double ScrollThreshold = 20;

private void OnListViewScrolled(object sender, ScrolledEventArgs e)
{
    // 滚动到顶部时强制显示导航栏
    if (e.ScrollY <= 0)
    {
        NavigationPage.SetHasNavigationBar(this, true);
        _lastScrollY = e.ScrollY;
        return;
    }

    // 计算滚动差值,小于阈值不处理
    var diff = e.ScrollY - _lastScrollY;
    if (Math.Abs(diff) < ScrollThreshold) return;

    if (diff > 0)
    {
        // 向上滚动,隐藏导航栏
        NavigationPage.SetHasNavigationBar(this, false);
    }
    else
    {
        // 向下滚动,显示导航栏
        NavigationPage.SetHasNavigationBar(this, true);
    }

    _lastScrollY = e.ScrollY;
}

注意:请确保你的FlyoutPage的Detail属性是包裹在NavigationPage中,否则系统导航栏控制逻辑不生效。


方案2:丝滑动画实现(自定义导航栏)

如果要实现示例动图中的顺滑折叠效果,建议关闭系统导航栏,自定义顶部导航栏实现滚动联动,导航栏样式也可以灵活自定义。

修改后XAML代码

<ContentPage ...
             <!-- 关闭系统导航栏 -->
             NavigationPage.HasNavigationBar="False"
             Title="Home">
    <ContentPage.Content>
        <Grid>
            <!-- 自定义导航栏 -->
            <StackLayout x:Name="CustomNavigationBar"
                         BackgroundColor="{StaticResource Primary}"
                         HeightRequest="50"
                         VerticalOptions="Start"
                         Padding="15,0">
                <Grid>
                    <!-- 汉堡菜单按钮,用于呼出Flyout侧边栏 -->
                    <Button Text="☰" 
                            Clicked="OnHamburgerClicked"
                            BackgroundColor="Transparent"
                            TextColor="White"
                            HorizontalOptions="Start" />
                    <!-- 页面标题 -->
                    <Label Text="Home" 
                           TextColor="White" 
                           FontSize="18"
                           HorizontalOptions="Center"
                           VerticalOptions="Center" />
                </Grid>
            </StackLayout>

            <!-- ListView顶部Padding等于导航栏高度,避免内容被遮挡 -->
            <ListView x:Name="MainListView"
                      Padding="0,50,0,0"
                      VerticalOptions="FillAndExpand" 
                      HasUnevenRows="True" 
                      CachingStrategy="RecycleElement"
                      ItemsSource="{Binding ListItems}" 
                      SeparatorVisibility="None"
                      Scrolled="OnListViewScrolled">
                <ListView.ItemTemplate>
                    <DataTemplate>
                        <ViewCell>
                            <StackLayout>
                                <Label />
                            </StackLayout>
                        </ViewCell>
                    </DataTemplate>
                </ListView.ItemTemplate>
            </ListView>
        </Grid>
    </ContentPage.Content>
</ContentPage>

后台逻辑代码

private double _lastScrollY;
private const double ScrollThreshold = 10;
private double _navBarHeight => CustomNavigationBar.Height;

private async void OnListViewScrolled(object sender, ScrolledEventArgs e)
{
    // 滚动到顶部时导航栏完全显示
    if (e.ScrollY <= 0)
    {
        await CustomNavigationBar.TranslateTo(0, 0, 150);
        MainListView.Padding = new Thickness(0, _navBarHeight, 0, 0);
        _lastScrollY = e.ScrollY;
        return;
    }

    var diff = e.ScrollY - _lastScrollY;
    if (Math.Abs(diff) < ScrollThreshold) return;

    if (diff > 0 && CustomNavigationBar.TranslationY == 0)
    {
        // 向上滚动,导航栏上移隐藏
        await CustomNavigationBar.TranslateTo(0, -_navBarHeight, 150);
        MainListView.Padding = new Thickness(0, 0, 0, 0);
    }
    else if (diff < 0 && CustomNavigationBar.TranslationY == -_navBarHeight)
    {
        // 向下滚动,导航栏下移显示
        await CustomNavigationBar.TranslateTo(0, 0, 150);
        MainListView.Padding = new Thickness(0, _navBarHeight, 0, 0);
    }

    _lastScrollY = e.ScrollY;
}

private void OnHamburgerClicked(object sender, EventArgs e)
{
    // 呼出FlyoutPage侧边菜单
    if (Parent is FlyoutPage flyoutPage)
    {
        flyoutPage.IsPresented = !flyoutPage.IsPresented;
    }
}

提示:如果后续替换为CollectionView组件,滚动监听逻辑完全通用,只需要替换对应的滚动事件即可。

内容的提问来源于stack exchange,提问作者Junaid Pathan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.14 06:18:03