跨平台开发 / 系统课时
用 SliverAppBar 做折叠头部
用 SliverAppBar 做折叠头部
本篇解决 Flutter 长列表页面中顶部区域随滚动展开、收缩和吸顶的问题。通过 SliverAppBar 配合 CustomScrollView,可以实现类似资讯类 App 的沉浸式头部效果。
学习目标
- 理解 SliverAppBar 的折叠机制和关键参数
- 掌握 SliverAppBar 与 CustomScrollView 的组合方式
- 能根据页面需求选择展开、吸顶和固定头部行为
SliverAppBar 解决的滚动问题
普通 AppBar 位于 Scaffold 的固定区域,不参与列表滚动。当页面需要头像、封面图、标题栏随着内容滚动变化时,固定 AppBar 很难表达这种关系。
SliverAppBar 属于 Sliver 系列组件,可以作为 CustomScrollView 的一部分参与滚动布局。它会根据滚动位置改变自身高度,并通过参数控制折叠后的状态。
常见场景包括:
- 用户主页顶部头像和背景图折叠
- 商品详情页图片区域缩小
- 新闻详情页标题栏吸顶

使用 SliverAppBar 构建折叠头部
SliverAppBar 通常放在 CustomScrollView 的 slivers 列表中。下面示例创建一个可展开的头部区域,并在折叠后保留导航栏。
dart
import 'package:flutter/material.dart';
class ProfilePage extends StatelessWidget {
const ProfilePage({super.key});
@override
Widget build(BuildContext context) {
return Scaffold(
body: CustomScrollView(
slivers: [
SliverAppBar(
pinned: true,
expandedHeight: 240,
flexibleSpace: FlexibleSpaceBar(
title: const Text('用户主页'),
background: Image.network(
'https://example.com/avatar.jpg',
fit: BoxFit.cover,
),
),
),
SliverList(
delegate: SliverChildBuilderDelegate(
(context, index) => ListTile(
title: Text('内容 $index'),
),
childCount: 20,
),
),
],
),
);
}
}预期结果
text
页面打开时显示 240 高度的头部区域。
向上滚动列表时,背景图片区域逐渐收缩。
折叠完成后,顶部保留显示“用户主页”的导航栏。理解关键参数
| 参数 | 作用 | 典型使用场景 |
|---|---|---|
| expandedHeight | 设置展开状态高度 | 图片头部、个人资料页 |
| pinned | 折叠后是否继续固定在顶部 | 需要持续显示标题时 |
| floating | 是否在向下滚动时快速出现 | 快速访问工具栏 |
| snap | 配合 floating 实现吸附动画 | 类似浏览器工具栏效果 |
| flexibleSpace | 定义展开区域内容 | 图片、渐变背景、复杂头部 |
pinned、floating 和 snap 经常组合使用,但它们解决的问题不同。pinned 控制折叠后的存在状态,floating 控制出现时机,snap 控制出现动画。
选择合适的折叠策略
如果页面顶部内容只是视觉装饰,可以只使用 expandedHeight 和 flexibleSpace。如果标题需要始终可见,应开启 pinned。
如果页面需要类似短视频应用的快速隐藏和显示效果,可以考虑 floating,但需要注意它会改变用户滚动时的视觉反馈。
实际开发中,应避免在 SliverAppBar 中放置过重组件,例如复杂动画列表或大量网络请求组件。头部会频繁参与布局计算,过重会影响滚动流畅度。
使用 SliverAppBar 时,重点不是堆叠参数,而是明确头部在滚动过程中的状态变化:展开时展示什么,折叠后保留什么,以及用户何时需要重新看到它。
按自己的节奏,确认真正理解。