GridView 可以构建一个二维网格列表,其默认构造函数定义如下:

  1. GridView({
  2. Axis scrollDirection = Axis.vertical,
  3. bool reverse = false,
  4. ScrollController controller,
  5. bool primary,
  6. ScrollPhysics physics,
  7. bool shrinkWrap = false,
  8. EdgeInsetsGeometry padding,
  9. @required SliverGridDelegate gridDelegate, // 控制子widget layout的委托
  10. bool addAutomaticKeepAlives = true,
  11. bool addRepaintBoundaries = true,
  12. double cacheExtent,
  13. List<Widget> children = const <Widget>[],
  14. })

gridDelegate

类型是 SliverGridDelegate,它的作用是控制 GridView 子组件如何排列(layout)。

SliverGridDelegate 是一个抽象类,定义了 GridView Layout 相关接口,子类需要通过实现它们来实现具体的布局算法。Flutter 中提供了两个 SliverGridDelegate 的子类 SliverGridDelegateWithFixedCrossAxisCount 和 SliverGridDelegateWithMaxCrossAxisExtent,我们可以直接使用

SliverGridDelegateWithFixedCrossAxisCount

该子类实现了一个横轴为固定数量子元素的 layout 算法,其构造函数为:

  1. SliverGridDelegateWithFixedCrossAxisCount({
  2. @required double crossAxisCount,
  3. double mainAxisSpacing = 0.0,
  4. double crossAxisSpacing = 0.0,
  5. double childAspectRatio = 1.0,
  6. })
  • crossAxisCount 横轴子元素的数量。此属性值确定后子元素在横轴的长度就确定了,即 ViewPort 横轴长度除以 crossAxisCount 的商。
  • mainAxisSpacing 主轴方向的间距。
  • crossAxisSpacing 横轴方向子元素的间距。
  • childAspectRatio 子元素在横轴长度和主轴长度的比例。由于 crossAxisCount 指定后,子元素横轴长度就确定了,然后通过此参数值就可以确定子元素在主轴的长度。

示例:

  1. GridView(
  2. gridDelegate: SliverGridDelegateWithFixedCrossAxisCount(
  3. crossAxisCount: 3, // 横轴三个子widget
  4. childAspectRatio: 1.0 // 宽高比为1时,子widget
  5. ),
  6. children:<Widget>[
  7. Icon(Icons.ac_unit, size: 64,),
  8. Icon(Icons.airport_shuttle, size: 64),
  9. Icon(Icons.all_inclusive, size: 64),
  10. Icon(Icons.beach_access, size: 64),
  11. Icon(Icons.cake, size: 64),
  12. Icon(Icons.free_breakfast, size: 64),
  13. ]
  14. )

效果:
010.png

GridView.count

GridView.count 构造函数内部使用了 SliverGridDelegateWithFixedCrossAxisCount,我们通过它可以快速的创建横轴固定数量子元素的 GridView,上面的示例代码等价于:

  1. GridView.count(
  2. crossAxisCount: 3,
  3. childAspectRatio: 1.0,
  4. children: <Widget>[
  5. Icon(Icons.ac_unit, size: 64,),
  6. Icon(Icons.airport_shuttle, size: 64),
  7. Icon(Icons.all_inclusive, size: 64),
  8. Icon(Icons.beach_access, size: 64),
  9. Icon(Icons.cake, size: 64),
  10. Icon(Icons.free_breakfast, size: 64),
  11. ],
  12. )

SliverGridDelegateWithMaxCrossAxisExtent

该子类实现了一个横轴子元素为固定最大长度的 layout 算法,其构造函数为:

  1. SliverGridDelegateWithMaxCrossAxisExtent({
  2. double maxCrossAxisExtent,
  3. double mainAxisSpacing = 0.0,
  4. double crossAxisSpacing = 0.0,
  5. double childAspectRatio = 1.0,
  6. })

maxCrossAxisExtent 为子元素在横轴上的最大长度,之所以是“最大”长度,是因为横轴方向每个子元素的长度仍然是等分的,举个例子,如果 ViewPort 的横轴长度是 450,那么当 maxCrossAxisExtent 的值在区间[450/4,450/3)内的话,子元素最终实际长度都为 112.5,而 childAspectRatio 所指的子元素横轴和主轴的长度比为最终的长度比。其它参数和 SliverGridDelegateWithFixedCrossAxisCount 相同。

  1. GridView(
  2. padding: EdgeInsets.zero,
  3. gridDelegate: SliverGridDelegateWithMaxCrossAxisExtent(
  4. maxCrossAxisExtent: 200.0,
  5. childAspectRatio: 2.0 // 宽高比为2
  6. ),
  7. children: <Widget>[
  8. Icon(Icons.ac_unit),
  9. Icon(Icons.airport_shuttle),
  10. Icon(Icons.all_inclusive),
  11. Icon(Icons.beach_access),
  12. Icon(Icons.cake),
  13. Icon(Icons.free_breakfast),
  14. ],
  15. )

GridView.extent

GridView.extent 构造函数内部使用了 SliverGridDelegateWithMaxCrossAxisExtent,我们通过它可以快速的创建纵轴子元素为固定最大长度的的 GridView,上面的示例代码等价于:

  1. GridView.extent(
  2. maxCrossAxisExtent: 120.0,
  3. childAspectRatio: 2.0,
  4. children: <Widget>[
  5. Icon(Icons.ac_unit),
  6. Icon(Icons.airport_shuttle),
  7. Icon(Icons.all_inclusive),
  8. Icon(Icons.beach_access),
  9. Icon(Icons.cake),
  10. Icon(Icons.free_breakfast),
  11. ],
  12. );

GridView.builder

上面我们介绍的 GridView 都需要一个 widget 数组作为其子元素,这些方式都会提前将所有子 widget 都构建好,所以只适用于子 widget 数量比较少时,当子 widget 比较多时,我们可以通过 GridView.builder 来动态创建子 widget。GridView.builder 必须指定的参数有两个:

  1. GridView.builder(
  2. ...
  3. @required SliverGridDelegate gridDelegate,
  4. @required IndexedWidgetBuilder itemBuilder,
  5. )

其中 itemBuilder 为子 widget 构建器。

从数据源获取菜单

假设我们需要从一个异步数据源(如网络)分批获取一些 Icon,然后用 GridView 来展示:

  1. class InfiniteGridView extends StatefulWidget {
  2. @override
  3. _InfiniteGridViewState createState() => new _InfiniteGridViewState();
  4. }
  5. class _InfiniteGridViewState extends State<InfiniteGridView> {
  6. List<IconData> _icons = []; //保存Icon数据
  7. @override
  8. void initState() {
  9. // 初始化数据
  10. _retrieveIcons();
  11. }
  12. @override
  13. Widget build(BuildContext context) {
  14. return GridView.builder(
  15. gridDelegate: SliverGridDelegateWithFixedCrossAxisCount(
  16. crossAxisCount: 3,
  17. childAspectRatio: 1.0
  18. ),
  19. itemCount: _icons.length,
  20. itemBuilder: (context, index) {
  21. if (index == _icons.length - 1 && _icons.length < 200) {
  22. _retrieveIcons();
  23. }
  24. return Icon(_icons[index], size: 64,);
  25. }
  26. );
  27. }
  28. void _retrieveIcons() {
  29. Future.delayed(Duration(milliseconds: 200)).then((e) {
  30. setState(() {
  31. _icons.addAll([
  32. Icons.ac_unit,
  33. Icons.airport_shuttle,
  34. Icons.all_inclusive,
  35. Icons.beach_access, Icons.cake,
  36. Icons.free_breakfast
  37. ]);
  38. });
  39. });
  40. }
  41. }

_retrieveIcons():在此方法中我们通过 Future.delayed 来模拟从异步数据源获取数据,每次获取数据需要 200 毫秒,获取成功后将新数据添加到_icons,然后调用 setState 重新构建。

在 itemBuilder 中,如果显示到最后一个时,判断是否需要继续获取数据,然后返回一个 Icon。

flutter_staggered_grid_view

Flutter 的 GridView 默认子元素显示空间是相等的,但在实际开发中,你可能会遇到子元素大小不等的情况,
Pub 上有一个包 flutter_staggered_grid_view,它实现了一个交错 GridView 的布局模型,可以很轻松的实现这种布局

示例:

  1. StaggeredGridView.countBuilder(
  2. crossAxisCount: 4,
  3. itemCount: 12,
  4. itemBuilder: (BuildContext context, int index) => new Container(
  5. color: Colors.green,
  6. child: new Center(
  7. child: new CircleAvatar(
  8. backgroundColor: Colors.white,
  9. child: new Text('$index'),
  10. ),
  11. )),
  12. staggeredTileBuilder: (int index) =>
  13. StaggeredTile.count(2, index.isEven ? 2 : 1),
  14. mainAxisSpacing: 8.0,
  15. crossAxisSpacing: 4.0,
  16. )

效果:
011.png

更多例子参考: flutter_staggered_grid_view examples

貌似此插件滚动有问题,GitHub 上有很多人提相关 scroll 的 issue,过段时间再看看有没有解决!