什么是SliverAppBar?
在Flutter中,SliverAppBar是AppBar部件的继承者,它允许您创建浮动的应用栏效果。SliverAppBar在屏幕向上滚动时展开AppBar,向下滚动时折叠。
当用户向下滚动一个长的列表时,你也可以完全删除或隐藏AppBar。SliverAppBar有很多自定义选项,所以你可以根据你的需要来定制它。
如果你是一个视觉学习者,可以看看这个快速视频教程。
下面是让SliverAppBar启动和运行的最小代码。
return Scaffold(
//1
body: CustomScrollView(
slivers: <Widget>[
//2
SliverAppBar(
expandedHeight: 250.0,
flexibleSpace: FlexibleSpaceBar(
title: Text('Goa', textScaleFactor: 1),
background: Image.asset(
'assets/images/beach.png',
fit: BoxFit.fill,
),
),
),
//3
SliverList(
delegate: SliverChildBuilderDelegate(
(_, int index) {
return ListTile(
leading: Container(
padding: EdgeInsets.all(8),
width: 100,
child: Placeholder()),
title: Text('Place ${index + 1}', textScaleFactor: 2),
);
},
childCount: 20,
),
),
],
),
);
要添加CustomScrollView,请将CustomScrollView
,放在Scaffold widget的body部分。这是用来同步AppBar和列表的滚动位置的。
有几个小部件可以被添加到CustomScrollView中,SliverAppBar就是其中之一。
SliverAppBar提供了普通AppBar小部件的所有功能,并增加了动画功能。flexibleSpace
,用于在AppBar展开时显示任何小部件。expandedHeight
,用于设置FlexibleSpaceBar这个小部件的高度。
SliverList显示项目的列表。我们不能使用普通的ListView类,因为CustomScrollView接受sliver类型的widget。
下面是输出结果。
![](https://img.haomeiwen.com/i27820348/6b63367fd17e2000.gif)
海滩图片来源:vecteezy.com。
这里是代码如何转化为设计的。
![](https://img.haomeiwen.com/i27820348/d62ad4f871d71d73.png)
自定义浮动行为
默认行为将在向下滚动时隐藏SliverAppBar,向上滚动时到达列表中的第一个项目时展开。然而,SliverAppBar有选项可以自定义这种行为。
SliverAppBar有三个重要的属性,即pinned
,snap
和floating
。设置这三个参数的组合可以使SliverAppBar按照你的需要工作。
让我们通过一个实际的例子来证明这些属性是如何工作的。
pinned: true,snap: false,floating: false:
只设置一个钉子的值为true
,当向下滚动时,SliverAppBar就会粘在顶部。当向上滚动时,SliverAppBar只在到达列表中的第一个项目时展开。
![](https://img.haomeiwen.com/i27820348/18fcbbe2ce983dd8.gif)
pinned: true,snap: true,floating: true:
当所有的参数都设置为true
,SliverAppBar在向下滚动时停留在顶部,向上滚动时完全展开,即使没有到达列表中的第一个项目。
![](https://img.haomeiwen.com/i27820348/77e26ecab5048d8e.gif)
pinned: true,snap: false,floating: true:
当只有snap值被设置为false
,SliverAppBar在向下滚动时保持在顶部。当我们向上滚动时,背景图片开始膨胀,并随着我们的滚动而停止。
![](https://img.haomeiwen.com/i27820348/d6bd10cb8fde1fc8.gif)
pinned: false,snap: false,floating: true:
只将浮动值设置为true
,在向下滚动时隐藏SliverAppBar,当我们向上滚动时开始显示背景图片。
![](https://img.haomeiwen.com/i27820348/af83576881d2a566.gif)
pinned: false,snap: true,floating: true:
如果你想让SliverAppBar在向下滚动时保持隐藏,而在向上滚动时显示完整的背景图片,即使是在列表中的第一个项目没有显示时。你可以只设置snap和floating为true
。
![](https://img.haomeiwen.com/i27820348/374e431ecc5306e9.gif)
在SliverAppBar内添加AppBar
需要注意的是,SliverAppBar并不能完全替代正常的AppBar。在Flutter中编写应用程序的好处是,你可以混合和匹配小部件来创造新的东西。
例如,你可能会遇到这样的情况:你需要在SliverAppBar内显示一个包含搜索框的AppBar。
让我们看一个例子。下面是一个电子商务应用程序,当向下滚动时,横幅图片被隐藏,而搜索框仍然停留在顶部。
![](https://img.haomeiwen.com/i27820348/d3de2ebcaca8b887.gif)
下面是如何做到这一点的。
Scaffold(
body: CustomScrollView(
slivers: <Widget>[
SliverAppBar(
...
bottom: AppBar(
title: Container(
height: 45,
child: TextField(
decoration: InputDecoration(
border: OutlineInputBorder(),
hintText: 'Enter a search term'),
),
),
),
),
SliverGrid(
gridDelegate: SliverGridDelegateWithFixedCrossAxisCount(
crossAxisCount: 2,
childAspectRatio: 2,
),
delegate: SliverChildBuilderDelegate(
(BuildContext context, int index) {
return ItemTile(index);
},
),
),
],
),
)
让我们来分解一下代码。首先,只要在SliverAppBar的bottom
属性中写一个普通的AppBar。该AppBar将包含TextField部件作为搜索项目的输入框。
项目的列表显示在SliverGrid中。由于我们使用了CutomScrollView,我们不能在这里使用普通的GridView。
用SliverAppBar添加TabBar
TabBar小部件用于显示不同类别的内容或用户可用的功能。在某些情况下,你可能想用SliverAppBar来显示TabBar。
让我们来看看如何添加TabBar并使其表现得像下面的例子。
![](https://img.haomeiwen.com/i27820348/915e489845b71473.gif)
Scaffold(
body: DefaultTabController(
length: 3,
child: NestedScrollView(
headerSliverBuilder:
(BuildContext context, bool innerBoxIsScrolled) {
return <Widget>[
SliverAppBar(
pinned: false,
expandedHeight: 250.0,
flexibleSpace: FlexibleSpaceBar(
title: Text('Goa', textScaleFactor: 1),
background: Image.asset(
'assets/images/beach.png',
fit: BoxFit.fill,
),
stretchModes: [StretchMode.zoomBackground],
),
//collapsedHeight: 100,
),
SliverPersistentHeader(
delegate: MySliverPersistentHeaderDelegate(
TabBar(
tabs: [
Tab(icon: Icon(Icons.flight)),
Tab(icon: Icon(Icons.directions_transit)),
Tab(icon: Icon(Icons.directions_car)),
],
),
),
pinned: false,
),
];
},
body: TabBarView(
children: [
Icon(Icons.flight, size: 350),
Icon(Icons.directions_transit, size: 350),
Icon(Icons.directions_car, size: 350),
],
),
),
),
)
NestedScrollView部件被用来返回标题,作为SliverAppBar和SliverPersistentHeader部件的组合。SliverAppBar内部使用SliverPersistentHeader来实现收缩和增长的效果。你可以使用这个小部件来显示SliverAppBar下面的标签。
TabBarView在NestedScrollView widget的body
参数中给出。
下面是上面的代码如何转化为设计。
![](https://img.haomeiwen.com/i27820348/979b8702a9a2a517.png)
钉住TabBar
如果你仔细观察,当向下滚动时,TabBar是隐藏的。为了改善用户体验,在向下滚动时,你应该始终保持TabBar在顶部可见。
在SliverPersistentHeader中设置pinned
值为true
,将解决这个问题。
SliverPersistentHeader(
delegate: MySliverPersistentHeaderDelegate(
TabBar(
tabs: [
...
],
),
),
pinned: true,
)
下面是它的工作原理。
![](https://img.haomeiwen.com/i27820348/4106474321c2738b.gif)
监听SliverAppBar的状态(展开或折叠
如果想要监听SliverAppBar的状态,以确定它是展开的还是折叠的,你可以使用返回的值来改变SliverAppBar的设置。例如,当它被展开时,你可以改变标题的文本颜色。
late ScrollController _scrollController;
//----------
@override
void initState() {
// TODO: implement initState
super.initState();
_scrollController = ScrollController()
..addListener(() {
setState(() {
_textColor = _isSliverAppBarExpanded ? Colors.white : Colors.blue;
});
});
}
//----------
bool get _isSliverAppBarExpanded {
return _scrollController.hasClients &&
_scrollController.offset > (200 - kToolbarHeight);
}
//----------
Scaffold(
body: CustomScrollView(
controller: _scrollController,
slivers: ...,
),
);
- ScrollController被创建并分配给CustomScrollView
- 监听器被添加到ScrollController中,以计算SliverAppBar是否被展开。
- 从监听器返回的值被用来设置标题的文本颜色。
下面是当SliverAppBar展开时改变标题 "Goa "颜色的输出。
![](https://img.haomeiwen.com/i27820348/f6b792524a64ea1e.gif)
结论
如果你已经走到了这一步,你应该具备了在你的Flutter应用程序中添加SliverAppBar的所有必要知识。
这个例子中使用的完整代码可以在GitHub上找到。
网友评论