Expandable ListView in Flutter

In this blog, We are going to learn how we can create an expandable listview in our Flutter applications. Expandable ListView is a type of list view that is used to show multiple types of data based on category and subcategory. Expandable list view is used to expand or collapse the view in list items In a flutter app. We can easily make our own Expandable ListView using the ExpansionTile widget.

You may also check our Flutter app development services.

Expansions Tile Widget :

ExpansionTiles is used to produce two-level or multi-level lists in the app. ExpansionTiles widget is a detailed tile. It is like a ListTile widget which will expand by tapping the tile. We can display some detailed information on the list with ExpansionTiles.

Properties of the Expansions Tile :

title: The title property allows you to display the title for the expansion tile widget.
subTitle: The subTitle property allows you to display additional content below the title.
children: The children’s property holds any number of widgets. The children’s widgets are displayed when the tile expands.
leading: The leading property allows you to display a leading icon or text.
trailing: Use the trailing property to the right after the title, you can use text and icons in this property.
backgroundColor: The background property gives color to the background of the expanded tile. Note, it assigns a color to the extended tile.
onExpensionChanged: This function is called with the value true, When the tile collapses, this function is called with the value false.

Code For Expandable listview:

Here’s the complete code ->

main.dart file

import 'package:expanded_listview_demo/subCategory.dart';
import 'package:flutter/material.dart';
import 'dataModel.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  @override
  State&lt;MyApp&gt; createState() =&gt; _MyAppState();
}


class _MyAppState extends State&lt;MyApp&gt; {
  List&lt;Menu&gt; data = &#091;];

  @override
  void initState() {
    dataList.forEach((element) {
      data.add(Menu.fromJson(element));
    });
    super.initState();
  }
  @override
   Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        drawer: _drawer(data),
        appBar: AppBar(
          title: const Text('Expandable ListView'),
        ),
        body: ListView.builder(
          itemCount: data.length,
          itemBuilder: (BuildContext context, int index) =&gt;
              _buildList(data&#091;index]),
        ),
      ),
    );
  }

  Widget _drawer (List&lt;Menu&gt; data){
    return Drawer(
        child: SafeArea(
          child: SingleChildScrollView(
            child: Column(
              children: &#091;
                UserAccountsDrawerHeader(margin: EdgeInsets.only(bottom: 0.0),
                    accountName: Text('demo'), accountEmail: Text('demo@webkul.com')),
                ListView.builder(
                  shrinkWrap: true,
                  physics: NeverScrollableScrollPhysics(),
                  itemCount: data.length,
                  itemBuilder:(context, index){return _buildList(data&#091;index]);},)
              ],
            ),
          ),
        ));
  }

  Widget _buildList(Menu list) {
    if (list.subMenu.isEmpty)
      return Builder(
        builder: (context) {
          return ListTile(
              onTap:() =&gt; Navigator.push(context, MaterialPageRoute(builder: (context) =&gt; SubCategory(list.name))),
              leading: SizedBox(),
              title: Text(list.name)
          );
        }
      );
    return ExpansionTile(
      leading: Icon(list.icon),
      title: Text(
        list.name,
        style: TextStyle(fontSize: 18, fontWeight: FontWeight.bold),
      ),
      children: list.subMenu.map(_buildList).toList(),
    );
  }
}

import 'package:expanded_listview_demo/subCategory.dart';

import 'package:flutter/material.dart';

import 'dataModel.dart';

void main() {

runApp(MyApp());

}

class MyApp extends StatefulWidget {

@override

State<MyApp> createState() => _MyAppState();

}

class _MyAppState extends State<MyApp> {

List<Menu> data = [];

@override

void initState() {

dataList.forEach((element) {

data.add(Menu.fromJson(element));

});

super.initState();

}

@override

Widget build(BuildContext context) {

return MaterialApp(

home: Scaffold(

drawer: _drawer(data),

appBar: AppBar(

title: const Text('Expandable ListView'),

body: ListView.builder(

itemCount: data.length,

itemBuilder: (BuildContext context, int index) =>

_buildList(data[index]),

);

}

Widget _drawer (List<Menu> data){

return Drawer(

child: SafeArea(

child: SingleChildScrollView(

child: Column(

children: [

UserAccountsDrawerHeader(margin: EdgeInsets.only(bottom: 0.0),

accountName: Text('demo'), accountEmail: Text('[email protected]')),

ListView.builder(

shrinkWrap: true,

physics: NeverScrollableScrollPhysics(),

itemCount: data.length,

itemBuilder:(context, index){return _buildList(data[index]);},)

));

}

Widget _buildList(Menu list) {

if (list.subMenu.isEmpty)

return Builder(

builder: (context) {

return ListTile(

onTap:() => Navigator.push(context, MaterialPageRoute(builder: (context) => SubCategory(list.name))),

leading: SizedBox(),

title: Text(list.name)

);

}

);

return ExpansionTile(

leading: Icon(list.icon),

title: Text(

list.name,

style: TextStyle(fontSize: 18, fontWeight: FontWeight.bold),

children: list.subMenu.map(_buildList).toList(),

);

}

datamodel.dart file ->

import 'package:flutter/material.dart';

List dataList = &#091;
  {
    "name": "Sales",
    "icon": Icons.payment,
    "subMenu": &#091;
      {"name": "Orders"},
      {"name": "Invoices"}
    ]
  },
  {
    "name": "Marketing",
    "icon": Icons.volume_up,
    "subMenu": &#091;
      {
        "name": "Promotions",
        "subMenu": &#091;
          {"name": "Catalog Price Rule"},
          {"name": "Cart Price Rules"}
        ]
      },
      {
        "name": "Communications",
        "subMenu": &#091;
          {"name": "Newsletter Subscribers"}
        ]
      },
      {
        "name": "SEO &amp; Search",
        "subMenu": &#091;
          {"name": "Search Terms"},
          {"name": "Search Synonyms"}
        ]
      },
      {
        "name": "User Content",
        "subMenu": &#091;
          {"name": "All Reviews"},
          {"name": "Pending Reviews"}
        ]
      }
    ]
  }
];

class Menu {
  String name;
  IconData icon;
  List&lt;Menu&gt; subMenu = &#091;];

  Menu({this.name, this.subMenu, this.icon});

  Menu.fromJson(Map&lt;String, dynamic&gt; json) {
    name = json&#091;'name'];
    icon = json&#091;'icon'];
    if (json&#091;'subMenu'] != null) {
      subMenu.clear();
      json&#091;'subMenu'].forEach((v) {
        subMenu?.add(new Menu.fromJson(v));
      });
    }
  }
}

import 'package:flutter/material.dart';

List dataList = [

{

"name": "Sales",

"icon": Icons.payment,

"subMenu": [

{"name": "Orders"},

{"name": "Invoices"}

]

{

"name": "Marketing",

"icon": Icons.volume_up,

"subMenu": [

{

"name": "Promotions",

"subMenu": [

{"name": "Catalog Price Rule"},

{"name": "Cart Price Rules"}

]

{

"name": "Communications",

"subMenu": [

{"name": "Newsletter Subscribers"}

]

{

"name": "SEO & Search",

"subMenu": [

{"name": "Search Terms"},

{"name": "Search Synonyms"}

]

{

"name": "User Content",

"subMenu": [

{"name": "All Reviews"},

{"name": "Pending Reviews"}

]

}

]

}

];

class Menu {

String name;

IconData icon;

List<Menu> subMenu = [];

Menu({this.name, this.subMenu, this.icon});

Menu.fromJson(Map<String, dynamic> json) {

name = json['name'];

icon = json['icon'];

if (json['subMenu'] != null) {

subMenu.clear();

json['subMenu'].forEach((v) {

subMenu?.add(new Menu.fromJson(v));

});

}

Outputs:

Conclusion

In this blog, we have discussed how we can create an expandable listview on our app screen. I hope it will help you out in understanding and get a brief idea about it.

Mohit Kumar

2 May, 2023
Updated by - Mohit Kumar
13 Jan, 2023
Updated by - Rohit Kashyap

. . .

4 comments

Safaa 2 years ago

Thanks for this tutorial. However, it needs
import ‘package:expanded_listview_demo/subCategory.dart’;

which is not available in the tutorial. Could You please provide it.

Mohit Kumar (Moderator) 2 years ago
Hi Safaa,This is a simple widget to show the details of a subcategory.
import ‘package:flutter/material.dart’;
class SubCategory extends StatelessWidget {
String? name;
SubCategory(this.name,{Key? key}) : super(key: key);
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: Text(name ??”),),
body: Center(child: Text(
“This is $name category screen”
),)
);
}
}

Reply

BurhanBey 2 years ago

Hello,
I have a simple table in my sqlite database with the following fields:
id, title, category

1, “Title 1”, “Video”
2, “Title 2”, “Audio”
3, “Title 3, “Video”

I want to group those with the same category and get a dataList like in your example. How can I do this?

Mohit Kumar (Moderator) 2 years ago
HiBurhanBey,

You need to fetch the data from the database and create a data model according to your need. After then you create the Expansions Tile according to you data.

Reply

Expandable ListView in Flutter

Expansions Tile Widget :

Properties of the Expansions Tile :

Code For Expandable listview:

Conclusion

Leave a Comment Cancel Reply

4 comments

Message Sent!