StaggeredGridView.countBuilder constructor

StaggeredGridView.countBuilder({
  1. Key? key,
  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 int crossAxisCount,
  10. required IndexedWidgetBuilder itemBuilder,
  11. required IndexedStaggeredTileBuilder staggeredTileBuilder,
  12. int? itemCount,
  13. double mainAxisSpacing = 0.0,
  14. double crossAxisSpacing = 0.0,
  15. bool addAutomaticKeepAlives = true,
  16. bool addRepaintBoundaries = true,
  17. String? restorationId,
})

Creates a scrollable, 2D array of widgets of variable sizes with a fixed number of tiles in the cross axis that are created on demand.

This constructor is appropriate for grid views with a large (or infinite) number of children because the builder is called only for those children that are actually visible.

Uses a SliverStaggeredGridDelegateWithFixedCrossAxisCount as the gridDelegate.

Providing a non-null itemCount improves the ability of the SliverStaggeredGridDelegate to estimate the maximum scroll extent.

itemBuilder and staggeredTileBuilder will be called only with indices greater than or equal to zero and less than itemCount.

The addAutomaticKeepAlives argument corresponds to the SliverVariableSizeChildListDelegate.addAutomaticKeepAlives property. The addRepaintBoundaries argument corresponds to the SliverVariableSizeChildListDelegate.addRepaintBoundaries property. Both must not be null.

Implementation

StaggeredGridView.countBuilder({
  Key? key,
  Axis scrollDirection = Axis.vertical,
  bool reverse = false,
  ScrollController? controller,
  bool? primary,
  ScrollPhysics? physics,
  bool shrinkWrap = false,
  EdgeInsetsGeometry? padding,
  required int crossAxisCount,
  required IndexedWidgetBuilder itemBuilder,
  required IndexedStaggeredTileBuilder staggeredTileBuilder,
  int? itemCount,
  double mainAxisSpacing = 0.0,
  double crossAxisSpacing = 0.0,
  bool addAutomaticKeepAlives = true,
  bool addRepaintBoundaries = true,
  String? restorationId,
})  : gridDelegate = SliverStaggeredGridDelegateWithFixedCrossAxisCount(
  crossAxisCount: crossAxisCount,
  mainAxisSpacing: mainAxisSpacing,
  crossAxisSpacing: crossAxisSpacing,
  staggeredTileBuilder: staggeredTileBuilder,
  staggeredTileCount: itemCount,
),
      childrenDelegate = SliverChildBuilderDelegate(
        itemBuilder,
        childCount: itemCount,
        addAutomaticKeepAlives: addAutomaticKeepAlives,
        addRepaintBoundaries: addRepaintBoundaries,
      ),
      super(
      key: key,
      scrollDirection: scrollDirection,
      reverse: reverse,
      controller: controller,
      primary: primary,
      physics: physics,
      shrinkWrap: shrinkWrap,
      padding: padding,
      restorationId: restorationId,
    );