fl_scroll_view
基于 easy_refresh 4.x 的可刷新滚动封装,内置 list / grid / masonry / aligned / quilted / staired / woven 与 StaggeredGrid。
要求 Flutter >= 3.47、material_ui。请用 package:material_ui/material_ui.dart 的 MaterialApp;若仍有依赖导入 package:flutter/material.dart,外层包一层 MaterialUiCompatibilityBridge。
综合示例
一个 FlRefreshableScrollView 内串联常用 sliver 与多种 ListLayout:
import 'package:fl_scroll_view/fl_scroll_view.dart';
import 'package:material_ui/material_ui.dart';
class ShowcasePage extends StatelessWidget {
const ShowcasePage({super.key});
static const quiltedPattern = [
QuiltedGridTile(2, 2),
QuiltedGridTile(1, 1),
QuiltedGridTile(1, 1),
QuiltedGridTile(1, 2),
];
static const stairedPattern = [
StairedGridTile(0.5, 1),
StairedGridTile(0.5, 3 / 4),
StairedGridTile(1.0, 10 / 4),
];
static const wovenPattern = [
WovenGridTile(1),
WovenGridTile(5 / 7, crossAxisRatio: 0.9, alignment: AlignmentDirectional.centerEnd),
];
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: const Text('fl_scroll_view')),
body: FlRefreshableScrollView(
padding: const EdgeInsets.all(10),
refreshConfig: FlEasyRefreshConfig(
onRefresh: (_) async {
await Future<void>.delayed(const Duration(seconds: 1));
return FlEasyRefreshResult.refreshSuccess;
},
onLoad: (_) async {
await Future<void>.delayed(const Duration(seconds: 1));
return FlEasyRefreshResult.loadingSuccess;
},
),
slivers: [
FlSliverPersistentHeader(
pinned: true,
minHeight: 48,
maxHeight: 96,
child: Container(
color: Colors.black87,
alignment: Alignment.center,
child: const Text('Pinned header', style: TextStyle(color: Colors.white)),
),
),
FlSliverPinnedToBoxAdapter(
child: Container(
height: 44,
color: Colors.deepOrange,
alignment: Alignment.center,
child: const Text('Pinned box', style: TextStyle(color: Colors.white)),
),
),
// list
FlSliverListLayout.builder(
layout: ListLayout.list(separatorBuilder: (_, __) => const SizedBox(height: 6)),
itemCount: 8,
itemBuilder: (_, i) => _Tile(i, height: 56),
),
// grid
FlSliverListLayout.builder(
layout: const ListLayout.gridCount(
crossAxisCount: 3,
mainAxisSpacing: 6,
crossAxisSpacing: 6,
),
itemCount: 9,
itemBuilder: (_, i) => _Tile(i + 8),
),
// masonry
FlSliverListLayout.builder(
layout: const ListLayout.masonryCount(
crossAxisCount: 2,
mainAxisSpacing: 6,
crossAxisSpacing: 6,
),
itemCount: 10,
itemBuilder: (_, i) => _Tile(i + 17, height: 60 + (i % 5) * 24),
),
// aligned
FlSliverListLayout.builder(
layout: const ListLayout.alignedCount(
crossAxisCount: 2,
mainAxisSpacing: 6,
crossAxisSpacing: 6,
),
itemCount: 8,
itemBuilder: (_, i) => _Tile(i + 27, height: i.isEven ? 100 : 48),
),
// quilted
FlSliverListLayout.builder(
layout: const ListLayout.quilted(
crossAxisCount: 4,
pattern: quiltedPattern,
mainAxisSpacing: 6,
crossAxisSpacing: 6,
),
itemCount: 8,
itemBuilder: (_, i) => _Tile(i + 35),
),
// staired
FlSliverListLayout.builder(
layout: const ListLayout.staired(
pattern: stairedPattern,
mainAxisSpacing: 6,
crossAxisSpacing: 6,
),
itemCount: 6,
itemBuilder: (_, i) => _Tile(i + 43),
),
// woven
FlSliverListLayout.builder(
layout: const ListLayout.wovenCount(
pattern: wovenPattern,
crossAxisCount: 2,
mainAxisSpacing: 6,
crossAxisSpacing: 6,
),
itemCount: 8,
itemBuilder: (_, i) => _Tile(i + 49),
),
// StaggeredGrid(非 sliver,包在 SliverToBoxAdapter 中)
SliverToBoxAdapter(
child: StaggeredGrid.count(
crossAxisCount: 4,
mainAxisSpacing: 6,
crossAxisSpacing: 6,
children: [
for (int i = 0; i < 12; i++)
StaggeredGridTile.count(
crossAxisCellCount: i.isEven ? 2 : 1,
mainAxisCellCount: i % 3 == 0 ? 2 : 1,
child: _Tile(i + 57),
),
],
),
),
],
),
);
}
}
class _Tile extends StatelessWidget {
const _Tile(this.index, {this.height = 80});
final int index;
final double height;
@override
Widget build(BuildContext context) {
final hue = (index * 47) % 360;
return Container(
height: height,
alignment: Alignment.center,
color: HSLColor.fromAHSL(1, hue.toDouble(), 0.72, 0.48).toColor(),
child: Text('$index', style: const TextStyle(color: Colors.white, fontWeight: FontWeight.bold)),
);
}
}
单独页面也可用 FlScrollListLayout.builder / .count,通过 layout: ListLayout.*(...) 切换样式。