ListView basics in Flutter

Introduction

A ListView helps you show many items in a scrollable list. It makes it easy to see long lists on small screens.

Showing a list of messages in a chat app.

Displaying a list of contacts or friends.

Listing products in a shopping app.

Showing a menu with many options.

Displaying search results that can scroll.

Syntax

Flutter

ListView(
  children: [
    Widget1(),
    Widget2(),
    Widget3(),
  ],
)

The children property takes a list of widgets to show in the list.

ListView automatically scrolls if items do not fit on the screen.

Examples

A simple list of three text items.

Flutter

ListView(
  children: [
    Text('Apple'),
    Text('Banana'),
    Text('Cherry'),
  ],
)

An empty list shows nothing but still scrolls if inside a scrollable parent.

Flutter

ListView(
  children: [],
)

A list with just one item.

Flutter

ListView(
  children: [
    Text('Only one item'),
  ],
)

Sample App

This app shows a scrollable list with 5 items using ListView and ListTile widgets.

Flutter

import 'package:flutter/material.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('ListView Basics')),
        body: ListView(
          children: const [
            ListTile(title: Text('Item 1')),
            ListTile(title: Text('Item 2')),
            ListTile(title: Text('Item 3')),
            ListTile(title: Text('Item 4')),
            ListTile(title: Text('Item 5')),
          ],
        ),
      ),
    );
  }
}

Important Notes

ListView scrolls vertically by default.

Use ListTile inside ListView for easy list rows with text and icons.

For very long lists, consider ListView.builder for better performance.

Summary

ListView shows a scrollable list of widgets.

Use the children property to add items.

It is great for showing lists that might be longer than the screen.

Practice

1. What is the main purpose of a ListView in Flutter?

easy

A. To create a fixed grid layout

B. To display a scrollable list of widgets

C. To handle user input forms

D. To manage app navigation

Solution

1. Step 1: Understand ListView's role

   ListView is designed to show multiple widgets in a scrollable list.

2. Step 2: Compare with other widgets

   Grid layouts or navigation are handled by other widgets, not ListView.

3. Final Answer:

   To display a scrollable list of widgets -> Option B

4. Quick Check:

   ListView = scrollable list [OK]

Hint: ListView always scrolls vertically by default [OK]

Common Mistakes:

• Confusing ListView with GridView
• Thinking ListView manages navigation
• Assuming ListView is for fixed layouts

2. Which of the following is the correct way to create a ListView with three Text widgets as children?

easy

A. ListView(children: Text('One'), Text('Two'), Text('Three'))

B. ListView(items: [Text('One'), Text('Two'), Text('Three')])

C. ListView(list: [Text('One'), Text('Two'), Text('Three')])

D. ListView(children: [Text('One'), Text('Two'), Text('Three')])

Solution

1. Step 1: Identify correct property for children

   The ListView uses the children property to accept a list of widgets.

2. Step 2: Check syntax correctness

   ListView(children: [Text('One'), Text('Two'), Text('Three')]) correctly uses children: [ ... ] with a list of Text widgets.

3. Final Answer:

   ListView(children: [Text('One'), Text('Two'), Text('Three')]) -> Option D

4. Quick Check:

   Use children property with a list [OK]

Hint: Use children: [widget1, widget2] for ListView items [OK]

Common Mistakes:

• Using wrong property like items or list
• Not wrapping widgets in a list
• Passing widgets without brackets

3. What will be the visible output when running this Flutter code?

ListView(
  children: [
    Text('Apple'),
    Text('Banana'),
    Text('Cherry')
  ],
)

medium

A. Only the first Text widget 'Apple' is shown

B. A horizontal scrollable list showing Apple, Banana, Cherry

C. A vertical scrollable list showing Apple, Banana, Cherry

D. An error because ListView needs a scrollDirection

Solution

1. Step 1: Understand default scroll direction

   ListView scrolls vertically by default, so children appear stacked vertically.

2. Step 2: Check children widgets

   Three Text widgets will appear in order: Apple, Banana, Cherry.

3. Final Answer:

   A vertical scrollable list showing Apple, Banana, Cherry -> Option C

4. Quick Check:

   Default scrollDirection = vertical [OK]

Hint: ListView scrolls vertically unless scrollDirection changes [OK]

Common Mistakes:

• Assuming horizontal scroll by default
• Thinking scrollDirection is required
• Expecting only one child visible

4. Identify the error in this ListView code snippet:

ListView(
  children: Text('Hello'),
)

medium

A. children expects a list of widgets, not a single widget

B. Text widget cannot be used inside ListView

C. ListView requires a scrollDirection property

D. Missing a comma after Text widget

Solution

1. Step 1: Check children property type

   The children property requires a list of widgets, e.g., [Text('Hello')].

2. Step 2: Identify the mistake

   Passing a single widget without brackets causes a type error.

3. Final Answer:

   children expects a list of widgets, not a single widget -> Option A

4. Quick Check:

   children = list of widgets [OK]

Hint: Always wrap children widgets in square brackets [OK]

Common Mistakes:

• Passing single widget without list brackets
• Forgetting children needs a list
• Adding unnecessary properties

5. You want to display a list of 100 numbers efficiently using ListView. Which approach is best?

hard

A. Use ListView.builder with itemCount and itemBuilder

B. Use ListView with 100 children widgets listed manually

C. Use a Column with 100 Text widgets inside a SingleChildScrollView

D. Use ListView without children or builder

Solution

1. Step 1: Understand performance with many items

   Manually listing 100 widgets wastes memory and slows app.

2. Step 2: Use ListView.builder for efficiency

   ListView.builder creates widgets on demand, improving performance.

3. Final Answer:

   Use ListView.builder with itemCount and itemBuilder -> Option A

4. Quick Check:

   ListView.builder = efficient large lists [OK]

Hint: Use ListView.builder for long or infinite lists [OK]

Common Mistakes:

• Listing all items manually in children
• Using Column for large scrollable lists
• Not specifying itemCount in builder