toggle_list

Package Overview

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

toggle_list is a Flutter package that provides an easy-to-use and highly customizable expandable list widget. It allows developers to create interactive lists with collapsible sections, ideal for organizing content in a clean, space-efficient manner. With support across all major platforms—Android, iOS, Web, macOS, Windows, and Linux—it ensures consistent behavior everywhere. The widget is designed for simplicity and flexibility, enabling customization of animations, icons, colors, and content structure. Perfect for settings panels, FAQs, or any hierarchical data display.

Use cases

Settings interfaces
FAQ sections
Hierarchical data displays
Collapsible navigation menus
Dynamic content grouping

Key features

Customizable expand/collapse animations
Support for multiple platform targets
Extensible widget design
Configurable icons and colors
Simple API for integration
Flexible content layout

Suitable for

Developers seeking expandable lists
UI designers needing interactive components
Apps with nested or grouped content
Cross-platform applications
Projects requiring minimal boilerplate

Considerations

Requires basic knowledge of Flutter widgets
May need additional styling for complex layouts
Limited to list-based expansion (not tree structures)
Not optimized for very large datasets without pagination

Original README

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

Logo

An easy-to-use and highly customizable expandable list widget for your Flutter application.

GitHub

This package is not yet widely tested.

Use it with caution and file any potential issues you see.

Installation

Via command line

flutter pub add toggle_list

Manually

Add the following line to your pubspec.yaml file.

dependencies:
  toggle_list: ^0.3.1

Then either save the file or use the flutter pub run command.

Import

import 'package:toggle_list/toggle_list.dart';

Usage

return Scaffold(
  body: ToggleList(
    children: [
      ToggleListItem(
        title: const Text('I am the first item'),
        content: const Padding(
          padding: EdgeInsets.all(20),
          child: Text('Hello there!'),
        ),
      ),
      ToggleListItem(
        title: const Text('I am the second item'),
        content: const Padding(
          padding: EdgeInsets.all(20),
          child: Text('I am delighted that you are here.'),
        ),
      ),
      ToggleListItem(
        title: const Text('I am the third item'),
        content: const Padding(
          padding: EdgeInsets.all(20),
          child: Text('Have a wonderful day!'),
        ),
      ),
    ],
  ),
);

For a more detailed use case, check out the example directory.

Contributing

Contributions of any kind are always welcome!

As of now, we don't have a standardized way for contributions. For this reason, if you would like to help us with your coding, feel free to send an email to [contact@binarybush.dev](mailto:contact@binarybush.dev).

Metadata

:green_book: Documentation

:email: [contact@binarybush.dev](mailto:contact@binarybush.dev)

:bug: Bug report

:zap: Requesting features

Every opened issue is very much appreciated!

Search packages, repositories and app categories

Install package