sticky_and_expandable_list
Flutter implementation of sticky headers and expandable list.Support use it in a CustomScrollView.
Features
- Build a grouped list, which support expand/collapse section and sticky header.
- Use it with CustomScrollView、SliverAppBar.
- Listen the scroll offset of current sticky header, current sticky header index and switching header index.
- Only use one list widget, so it supports large data and a normal memory usage.
- More section customization support, you can return a new section widget by sectionBuilder, to customize background，expand/collapse animation, section layout, and so on.
- Support add divider.
- Support overlap content.
- Support scroll to index like ListView, by scroll-to-index.
Getting Started
In the pubspec.yaml of your flutter project, add the following dependency:
dependencies:
sticky_and_expandable_list: ^1.0.3
Basic Usage
sectionList is a custom data source for ExpandableListView. We should create a model list to store the information of each section, the model must implement ExpandableListSection.
//In this example, we create a custom model class(ExampleSection).
//class ExampleSection implements ExpandableListSection
{}
//so: SliverExpandableChildDelegate
()
List<ExampleSection> sectionList = List<ExampleSection>();
return ExpandableListView(
builder: SliverExpandableChildDelegate<String, ExampleSection>(
sectionList: sectionList,
headerBuilder: (context, sectionIndex, index) =>
Text("Header #$sectionIndex"),
itemBuilder: (context, sectionIndex, itemIndex, index) {
String item = sectionList[sectionIndex].items[itemIndex];
return ListTile(
leading: CircleAvatar(
child: Text("$index"),
),
title: Text(item),
);
}),
);
If you want to use it with sliver widget, use SliverExpandableList instead of ExpandableListView.
FAQ
How to expand/collapse item?
setState(() {
sectionList[i].setSectionExpanded(true);
});
How to listen current sticky header or the sticky header scroll offset?
@override
Widget build(BuildContext context) {
ExpandableListView(
builder: SliverExpandableChildDelegate<String, ExampleSection>(
headerController: _getHeaderController(),
),
)
}
_getHeaderController() {
var controller = ExpandableListController();
controller.addListener(() {
print("switchingSectionIndex:${controller.switchingSectionIndex}, stickySectionIndex:" +
"${controller.stickySectionIndex},scrollPercent:${controller.percent}");
});
return controller;
}
How to set background for each section?
Use sectionBuilder
Customize expand/collapse animation support?
Change Log
Donate
Buy a cup of coffee for me (Scan by wechat)：
901 Dec 28, 2022
971 Jan 7, 2023
2 Aug 17, 2022
35 Oct 4, 2022
1 Nov 25, 2021
1.7k Jan 7, 2023
340 Jan 1, 2023
49 Oct 7, 2021
7 Dec 3, 2022
396 Mar 10, 2022
6 Dec 10, 2022
214 Dec 13, 2022
108 Sep 11, 2022
8 Oct 22, 2022
25 Dec 12, 2022
26 Dec 31, 2022
0 Apr 12, 2022
5 Jul 29, 2022
2 Jun 7, 2022