跨平台开发 / 系统课时

用 SliverAppBar 做折叠头部

用 SliverAppBar 做折叠头部

本篇解决 Flutter 长列表页面中顶部区域随滚动展开、收缩和吸顶的问题。通过 SliverAppBar 配合 CustomScrollView,可以实现类似资讯类 App 的沉浸式头部效果。

学习目标

  • 理解 SliverAppBar 的折叠机制和关键参数
  • 掌握 SliverAppBar 与 CustomScrollView 的组合方式
  • 能根据页面需求选择展开、吸顶和固定头部行为

SliverAppBar 解决的滚动问题

普通 AppBar 位于 Scaffold 的固定区域,不参与列表滚动。当页面需要头像、封面图、标题栏随着内容滚动变化时,固定 AppBar 很难表达这种关系。

SliverAppBar 属于 Sliver 系列组件,可以作为 CustomScrollView 的一部分参与滚动布局。它会根据滚动位置改变自身高度,并通过参数控制折叠后的状态。

常见场景包括:

  • 用户主页顶部头像和背景图折叠
  • 商品详情页图片区域缩小
  • 新闻详情页标题栏吸顶

SliverAppBar 展开到折叠的状态变化示意图

使用 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 时,重点不是堆叠参数,而是明确头部在滚动过程中的状态变化:展开时展示什么,折叠后保留什么,以及用户何时需要重新看到它。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 SliverAppBar 做折叠头部

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通