fl_scroll_view 3.0.1
fl_scroll_view: ^3.0.1 copied to clipboard
fl_scroll_view encapsulates and extends easy_refresh, and includes staggered grid layouts.
3.0.1 #
变更(破坏性) #
ListGridLayout更名为密封基类ListLayout,每种样式拆为独立工厂与独立类型:- 列表:
ListLayout.list({separatorBuilder})/ListLayout.fixed({itemExtent})/ListLayout.prototype({prototypeItem}) - 等分网格:
ListLayout.gridCount/ListLayout.gridExtent - 瀑布流:
ListLayout.masonryCount/ListLayout.masonryExtent - 行对齐:
ListLayout.alignedCount/ListLayout.alignedExtent - 图案网格:
ListLayout.quilted/ListLayout.staired/ListLayout.wovenCount/ListLayout.wovenExtent
- 列表:
crossAxisCount与maxCrossAxisExtent不再二选一:count / extent 拆为两个独立工厂,构造期即确定列数策略separatorBuilder从FlSliverListLayout.builder/FlScrollListLayout.builder移至ListLayout.list,与布局绑定;children/count模式自动忽略FlSliverListGrid/FlScrollListGrid更名为FlSliverListLayout/FlScrollListLayoutNoScrollBehavior更名为FlNoOverscrollBehavior:原名称易被误解为禁用滚动,实际只关闭过头滚动指示器FlRefreshScrollView更名为FlRefreshableScrollView- 网格 / 瀑布流 / 行对齐 / 图案布局的
mainAxisSpacing/crossAxisSpacing抽入共享基类,各布局只暴露自身参数 - 具体类型可按
switch (layout)细分:ListPlainLayout/ListFixedLayout/ListPrototypeLayout/ListGridCountLayout/ListGridExtentLayout/ListMasonryCountLayout/ListMasonryExtentLayout/ListAlignedCountLayout/ListAlignedExtentLayout/ListQuiltedLayout/ListStairedLayout/ListWovenCountLayout/ListWovenExtentLayout
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