fl_scroll_view 2.1.0
fl_scroll_view: ^2.1.0 copied to clipboard
fl_scroll_view encapsulates and extends easy_refresh, and includes staggered grid layouts.
2.1.0 #
修复 #
- 空数据 +
shrinkWrap/ 无界主轴时,placeholderFill不再强制使用SliverFillRemaining,避免无限高度断言 onRefresh/onLoad回调抛异常时自动标记失败并通过FlutterError.reportError上报,指示器不再停留在 processing 状态- 兼容外部
EasyRefreshController:无需手动开启controlFinishRefresh/controlFinishLoad,库会按配置自动结束或交由 EasyRefresh 结束 SliverQuiltedGridDelegate修复跨列 tile 起始列越界导致的RangeError红屏;indexList按最大 cell 索引补齐整行SliverQuiltedGridDelegate在 pattern 为空或QuiltedGridTile.crossAxisCount超过列数时构造期抛出ArgumentErrorFlSliverPinnedToBoxAdapter的cacheExtent对齐 FlutterPinnedHeaderSliver;滚动重建时不再触发语义配置断言maxCrossAxisExtent自适应列数至少为 1,避免极窄宽度下算出 0 列staired/woven布局的shouldRelayout按 pattern 内容比较,相同内容的新列表不再触发无谓重排;StairedGridTile/WovenGridTile补充==/hashCodealigned布局与findChildIndexCallback/findItemIndexCallback组合时在构造期给出断言提示- 空数据且
itemCount == 0时SliverAlignedGrid不再生成多余的分隔行
新增 #
FlOverscrollShift:下拉刷新时pinned/floating的FlSliverPersistentHeader与FlSliverPinnedToBoxAdapter跟随刷新指示器同步下移,避免遮挡刷新 header;上滑时仍保持固定
变更 #
FlEasyRefresh内部 controller 默认开启controlFinishRefresh/controlFinishLoad,统一接管任务结束- 补充
placeholderFill、physics、shrinkWrap、controller的优先级与默认行为文档
示例 #
- 示例重写为参数实验台:布局 / 刷新 / 滚动 / Sliver / 交错组件分页演示,支持明暗主题
- 示例移除
device_preview_minus,平台精简为 iOS / Web,并新增页面冒烟与布局回归测试
2.0.0 #
依赖与环境 #
- Flutter
>=3.47,Dart^3.13 easy_refresh^4.0.0- 移除依赖
flutter_staggered_grid_view,交错布局已内置进本包 - 新增依赖
material_ui;指示器 / 主题请改用package:material_ui/material_ui.dart(必要时包一层MaterialUiCompatibilityBridge)
列表样式 API #
布局参数收进密封类 ListGridLayout(定义于 sliver_list_grid.dart):
FlScrollListGrid.builder(
layout: const ListGridLayout.grid(crossAxisCount: 3),
itemCount: 20,
itemBuilder: (_, i) => Text('$i'),
);
FlScrollListGrid.builder(
layout: const ListGridLayout.quilted(
crossAxisCount: 4,
pattern: [
QuiltedGridTile(2, 2),
QuiltedGridTile(1, 1),
QuiltedGridTile(1, 1),
QuiltedGridTile(1, 2),
],
),
itemCount: 20,
itemBuilder: (_, i) => Text('$i'),
);
可用布局:list / grid / masonry / aligned / quilted / staired / woven。
separatorBuilder 行为对齐 ListView.separated;可用 findItemIndexCallback(返回 item 索引,库内自动 * 2)。
交错布局 #
从本包导入即可(不再依赖 flutter_staggered_grid_view):MasonryGridView、AlignedGridView、SliverMasonryGrid、SliverAlignedGrid、StaggeredGrid / StaggeredGridTile、QuiltedGridTile / SliverQuiltedGridDelegate、StairedGridTile / SliverStairedGridDelegate、WovenGridTile / SliverWovenGridDelegate、SliverSimpleGridDelegate* 等。
EasyRefresh #
- EasyRefresh 4 需配合
material_ui主题;ClassicHeader/ClassicFooter等仍由本包 re-export - 无全局
FlEasyRefreshControllers;在onRefresh/onLoad回调参数上使用EasyRefreshController,或显式传入FlEasyRefreshConfig.controller
FlEasyRefreshConfig(
onRefresh: (controller) async {
await load();
controller.finishRefresh(IndicatorResult.success);
// 或 return FlEasyRefreshResult.refreshSuccess;
},
);
其它 #
MasonryGridView/AlignedGridView使用scrollCacheExtent(Flutter 3.47)- 修复
StaggeredGrid固定 cell 尺寸时错误读取RenderBox.size的断言 - 修复
SliverMasonryGrid位于其他 sliver 上方时错误scrollOffsetCorrection导致回弹 separatorBuilder:非 list 布局构造期 assert;与itemExtent/prototypeItem同用时强制走SliverList