SingleChildScrollView in Flutter

Introduction

SingleChildScrollView lets you scroll a single widget when it is too big to fit on the screen. It helps avoid content being cut off.

You have a column of text and buttons that might not fit on small screens.

You want to make a form scrollable so users can reach all fields.

You want to scroll an image or a list that is not very long.

You want to avoid overflow errors when content size changes dynamically.

Syntax

Flutter

SingleChildScrollView(
  scrollDirection: Axis.vertical,
  child: YourWidget(),
)

scrollDirection controls if scrolling is vertical or horizontal.

The child is the single widget that will scroll if needed.

Examples

A vertical scroll with a column of text lines.

Flutter

SingleChildScrollView(
  child: Column(
    children: [Text('Line 1'), Text('Line 2')],
  ),
)

A horizontal scroll with a row of icons.

Flutter

SingleChildScrollView(
  scrollDirection: Axis.horizontal,
  child: Row(
    children: [Icon(Icons.star), Icon(Icons.star_border)],
  ),
)

Sample App

This app shows a list of 30 text items inside a SingleChildScrollView. You can scroll vertically to see all items.

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('SingleChildScrollView Example')),
        body: SingleChildScrollView(
          child: Column(
            children: List.generate(
              30,
              (index) => Padding(
                padding: const EdgeInsets.all(8.0),
                child: Text('Item ${index + 1}', style: const TextStyle(fontSize: 20)),
              ),
            ),
          ),
        ),
      ),
    );
  }
}

Important Notes

SingleChildScrollView should have only one child widget.

Use it when you want simple scrolling for a small number of widgets.

For large or infinite lists, use ListView instead for better performance.

Summary

SingleChildScrollView makes one widget scrollable when it doesn't fit.

Set scrollDirection to vertical or horizontal.

Good for small scrollable areas like forms or short lists.

Practice

1. What is the main purpose of SingleChildScrollView in Flutter?

easy

A. To make a single widget scrollable when it doesn't fit on the screen

B. To create a grid layout with multiple widgets

C. To handle user input in forms

D. To navigate between different screens

Solution

1. Step 1: Understand the widget's purpose

   SingleChildScrollView is designed to make one widget scrollable if it is too big for the screen.

2. Step 2: Compare with other options

   Options B, C, and D describe other Flutter widgets or features unrelated to scrolling a single child.

3. Final Answer:

   To make a single widget scrollable when it doesn't fit on the screen -> Option A

4. Quick Check:

   SingleChildScrollView = scrollable single widget [OK]

Hint: SingleChildScrollView scrolls one widget only [OK]

Common Mistakes:

• Confusing with ListView for multiple items
• Thinking it handles navigation
• Assuming it manages user input

2. Which of the following is the correct way to explicitly make a vertical scroll using SingleChildScrollView?

easy

A. SingleChildScrollView(child: Text('Hello')) without scrollDirection

B. SingleChildScrollView(scrollDirection: Axis.horizontal, child: Text('Hello'))

C. SingleChildScrollView(direction: Axis.vertical, child: Text('Hello'))

D. SingleChildScrollView(scrollDirection: Axis.vertical, child: Text('Hello'))

Solution

1. Step 1: Check the property name and value

   The correct property to set scroll direction is scrollDirection with value Axis.vertical for vertical scrolling.

2. Step 2: Analyze each option

   SingleChildScrollView(scrollDirection: Axis.horizontal, child: Text('Hello')) uses horizontal direction, wrong for vertical. SingleChildScrollView(direction: Axis.vertical, child: Text('Hello')) uses wrong property name direction. SingleChildScrollView(child: Text('Hello')) without scrollDirection does not explicitly specify vertical scrolling (defaults to vertical).

3. Final Answer:

   SingleChildScrollView(scrollDirection: Axis.vertical, child: Text('Hello')) -> Option D

4. Quick Check:

   scrollDirection = Axis.vertical for vertical scroll [OK]

Hint: Use scrollDirection: Axis.vertical for vertical scroll [OK]

Common Mistakes:

• Using wrong property name like 'direction'
• Confusing horizontal and vertical axis
• Omitting scrollDirection when explicit vertical scroll is required

3. What will happen when this Flutter code runs?

SingleChildScrollView(
  scrollDirection: Axis.horizontal,
  child: Row(
    children: [
      Container(width: 200, height: 100, color: Colors.red),
      Container(width: 200, height: 100, color: Colors.blue),
      Container(width: 200, height: 100, color: Colors.green),
    ],
  ),
)

medium

A. The app will crash due to wrong widget nesting

B. The row will scroll vertically showing all colored containers

C. The row will scroll horizontally showing all colored containers

D. The containers will be clipped and no scrolling happens

Solution

1. Step 1: Understand scrollDirection and child

   The SingleChildScrollView scrolls horizontally because scrollDirection: Axis.horizontal. The child is a Row with wide containers.

2. Step 2: Predict UI behavior

   The row's children exceed screen width, so horizontal scroll allows viewing all containers side by side.

3. Final Answer:

   The row will scroll horizontally showing all colored containers -> Option C

4. Quick Check:

   Horizontal scroll + Row = scrollable containers [OK]

Hint: Horizontal scroll with Row shows all children side by side [OK]

Common Mistakes:

• Assuming vertical scroll with horizontal axis
• Thinking containers get clipped without scroll
• Believing app crashes due to this nesting

4. Identify the error in this code snippet:

SingleChildScrollView(
  scrollDirection: Axis.vertical,
  child: Column(
    children: [
      Text('Line 1'),
      Text('Line 2'),
      Text('Line 3'),
    ],
  ),
  scrollDirection: Axis.horizontal,
)

medium

A. Duplicate scrollDirection property causes a syntax error

B. Column cannot be child of SingleChildScrollView

C. Missing a SizedBox to wrap Text widgets

D. No error, code runs fine

Solution

1. Step 1: Check property usage

   The code sets scrollDirection twice in the same widget, which is invalid syntax in Dart.

2. Step 2: Verify other parts

   Using Column as child is valid. No SizedBox needed for Text widgets. So only duplicate property is error.

3. Final Answer:

   Duplicate scrollDirection property causes a syntax error -> Option A

4. Quick Check:

   Duplicate properties cause syntax error [OK]

Hint: Check for duplicate properties in widget constructors [OK]

Common Mistakes:

• Thinking Column can't be child
• Assuming missing SizedBox is error
• Ignoring duplicate property syntax error

5. You want to create a scrollable form with multiple input fields stacked vertically. Which approach correctly uses SingleChildScrollView to avoid overflow errors?

hard

A. Column(
children: [TextField(), TextField(), TextField()]
) without scroll view

B. SingleChildScrollView(
child: Column(
children: [TextField(), TextField(), TextField()]
),
)

C. SingleChildScrollView(
scrollDirection: Axis.horizontal,
child: Column(
children: [TextField(), TextField(), TextField()]
),
)

D. ListView(
children: [TextField(), TextField(), TextField()]
) instead of SingleChildScrollView

Solution

1. Step 1: Understand scroll direction for vertical form

   A vertical form needs vertical scrolling, so SingleChildScrollView with default vertical scroll is correct.

2. Step 2: Evaluate options

   SingleChildScrollView( child: Column( children: [TextField(), TextField(), TextField()] ), ) uses vertical scroll with Column child, perfect for stacked inputs. SingleChildScrollView( scrollDirection: Axis.horizontal, child: Column( children: [TextField(), TextField(), TextField()] ), ) wrongly sets horizontal scroll. Column( children: [TextField(), TextField(), TextField()] ) without scroll view lacks scroll, causing overflow. ListView( children: [TextField(), TextField(), TextField()] ) instead of SingleChildScrollView uses ListView which works but is different widget.

3. Final Answer:

   SingleChildScrollView( child: Column( children: [TextField(), TextField(), TextField()] ), ) -> Option B

4. Quick Check:

   Vertical scroll + Column = scrollable form [OK]

Hint: Use vertical SingleChildScrollView with Column for forms [OK]

Common Mistakes:

• Setting horizontal scroll for vertical form
• Omitting scroll view causing overflow
• Confusing ListView with SingleChildScrollView