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
相关产品推荐
相关产品推荐

