foldable_list

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

FoldableList is a Flutter package that provides an animated, interactive list where items can expand and collapse with smooth transitions when tapped. It enhances user experience by allowing users to reveal additional content within list cells dynamically. Ideal for displaying hierarchical or detailed information in a compact layout, it supports all major platforms including Android, iOS, Web, macOS, Windows, and Linux. The package is lightweight and easy to integrate, making it suitable for apps requiring collapsible content sections.

Use cases

Displaying detailed information in a compact list
Creating accordion-style interfaces
Enhancing navigation with expandable sections
Building FAQ or settings panels
Showing nested data hierarchies

Key features

Smooth animated expansion and collapse
Customizable animation duration and curve
Support for multiple expandable items
Easy integration with existing ListView
Cross-platform compatibility

Suitable for

Developers building interactive UIs
Apps needing collapsible content
Designers seeking elegant expandable lists
Projects with dynamic data display
Mobile and web applications with rich interactions

Considerations

May impact performance with very large lists
Requires careful handling of state management
Animation behavior may vary slightly across platforms
Limited customization for complex layouts
Best suited for moderate numbers of expandable items

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Foldable List

An animated foldable list cells with dynamic widget list input, let you display detailed item cell without navigating to a new screen.

Features

Display list of widgets
Display detailed cell item
Animation transition between item cell and foldable item

Getting Started

In order to use foldable list package you need to install it via pubspec.yaml file

dependencies:
	foldable_list: ^1.0.1

Parameters

Name	Type	Description	Required
foldableItems	`List<Widget>`	List of widget items that will be shown when an item is clicked	True
items	`List<Widget>`	List of widgets that will be shown by default in the listview	True
animationDuration	Duration	the duration of the animation by default: `Duration(milliseconds: 500)`	False
animationType	`ANIMATION_TYPE`	the animation that will applied on the transition between items	False

possible values of animationType : NONE, SIZE_TRANSITION, SCALE

Example

return  Scaffold(
	backgroundColor:  Colors.white,
	body:  Container(
		child:  FoldableList(
			animationType:  ANIMATION_TYPE.NONE,
			foldableItems:  this.expandedWidgetList,
			items:  this.simpleWidgetList
		)
	)
);

Result:

Contribution

Of course the project is open source, and you can contribute to it repository link

If you found a bug, open an issue.
If you have a feature request, open an issue.
If you want to contribute, submit a pull request.

Search packages, repositories and app categories

Install package