CustomScrollView in Flutter - UI Render Trace

Component - CustomScrollView

The CustomScrollView widget in Flutter lets you create a scrollable area that can contain multiple scrollable elements called slivers. It is useful when you want to combine different scrolling effects or layouts in one scrollable view.

Widget Tree

CustomScrollView
├─ SliverAppBar
└─ SliverList
   ├─ ListItem 1
   ├─ ListItem 2
   ├─ ListItem 3
   └─ ...

The root widget is CustomScrollView which holds slivers. Here, a SliverAppBar is the top scrollable app bar, and below it is a SliverList containing multiple list items stacked vertically.

Render Trace - 3 Steps

Step 1: CustomScrollView

Step 2: SliverAppBar

Step 3: SliverList

State Change - Re-render

Trigger:User scrolls the list upwards

Before

SliverAppBar fully expanded, list items visible below

→

After

SliverAppBar shrinks and pins to top, list items scroll up under app bar

Re-renders:CustomScrollView subtree including SliverAppBar and SliverList re-renders to reflect scroll position

UI Quiz - 3 Questions

What does the SliverAppBar do when you scroll up?

A It disappears completely

B It shrinks and stays pinned at the top

C It expands to cover the whole screen

D It scrolls away with the list items

Key Insight

CustomScrollView is powerful for combining multiple scrollable areas with different behaviors. Using slivers lets you create flexible, smooth scrolling experiences like collapsible headers and dynamic lists in one scroll view.

Practice

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

easy

A. To combine multiple scrollable widgets called slivers into one scrollable area.

B. To create a fixed header without scrolling.

C. To display only a single scrollable list.

D. To handle user input events like taps and swipes.

Solution

1. Step 1: Understand the role of CustomScrollView

   CustomScrollView allows combining different scrollable widgets called slivers into one scrollable area.

2. Step 2: Compare options with this understanding

   Only To combine multiple scrollable widgets called slivers into one scrollable area. correctly describes this purpose; others describe unrelated features.

3. Final Answer:

   To combine multiple scrollable widgets called slivers into one scrollable area. -> Option A

4. Quick Check:

   CustomScrollView = combine slivers [OK]

Hint: Remember: CustomScrollView = multiple slivers scrolling together [OK]

Common Mistakes:

• Thinking CustomScrollView only shows one list
• Confusing CustomScrollView with fixed headers
• Assuming it handles input events directly

2. Which of the following is the correct way to start a CustomScrollView with a sliver list in Flutter?

easy

A. CustomScrollView(children: [SliverList(delegate: SliverChildBuilderDelegate((context, index) => Text('Item $index'), childCount: 10))])

B. CustomScrollView(slivers: [SliverList(delegate: SliverChildBuilderDelegate((context, index) => Text('Item $index'), childCount: 10))])

C. CustomScrollView(children: [ListView.builder(itemCount: 10, itemBuilder: (context, index) => Text('Item $index'))])

D. CustomScrollView(slivers: [ListView.builder(itemCount: 10, itemBuilder: (context, index) => Text('Item $index'))])

Solution

1. Step 1: Check CustomScrollView property for slivers

   CustomScrollView uses the slivers property to accept sliver widgets, not children.

2. Step 2: Identify correct sliver list syntax

   SliverList requires a delegate like SliverChildBuilderDelegate to build items lazily.

3. Final Answer:

   CustomScrollView(slivers: [SliverList(delegate: SliverChildBuilderDelegate((context, index) => Text('Item $index'), childCount: 10))]) -> Option B

4. Quick Check:

   Use slivers property with SliverList [OK]

Hint: Use slivers: [] property, not children: [] for CustomScrollView [OK]

Common Mistakes:

• Using children instead of slivers property
• Putting ListView inside CustomScrollView slivers
• Not using SliverChildBuilderDelegate for SliverList

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

CustomScrollView(
  slivers: [
    SliverAppBar(
      expandedHeight: 100,
      flexibleSpace: FlexibleSpaceBar(title: Text('Header')),
      pinned: true,
    ),
    SliverList(
      delegate: SliverChildListDelegate([
        Container(height: 50, color: Colors.red),
        Container(height: 50, color: Colors.green),
        Container(height: 50, color: Colors.blue),
      ]),
    ),
  ],
)

medium

A. An error because SliverAppBar cannot be used inside CustomScrollView.

B. A static screen with only the header 'Header' visible and no scrolling.

C. A scrollable screen with three colored boxes but no header visible.

D. A scrollable screen with a pinned header titled 'Header' and three colored boxes stacked vertically.

Solution

1. Step 1: Understand SliverAppBar behavior

   SliverAppBar with pinned: true stays visible at top when scrolling.

2. Step 2: Analyze SliverList content

   SliverList shows three containers stacked vertically with specified colors and heights.

3. Final Answer:

   A scrollable screen with a pinned header titled 'Header' and three colored boxes stacked vertically. -> Option D

4. Quick Check:

   SliverAppBar pinned + SliverList visible = A scrollable screen with a pinned header titled 'Header' and three colored boxes stacked vertically. [OK]

Hint: Pinned SliverAppBar stays visible while scrolling content below [OK]

Common Mistakes:

• Thinking header disappears on scroll
• Assuming no scrolling because of pinned header
• Believing SliverAppBar causes error inside CustomScrollView

4. Identify the error in this Flutter code using CustomScrollView:

CustomScrollView(
  children: [
    SliverList(
      delegate: SliverChildBuilderDelegate(
        (context, index) => Text('Item $index'),
        childCount: 5,
      ),
    ),
  ],
)

medium

A. SliverList cannot be used inside CustomScrollView.

B. Missing itemCount in SliverChildBuilderDelegate.

C. Using children instead of slivers property in CustomScrollView.

D. Text widget cannot be used inside SliverChildBuilderDelegate.

Solution

1. Step 1: Check CustomScrollView properties

   CustomScrollView expects sliver widgets inside the slivers property, not children.

2. Step 2: Verify other parts

   SliverChildBuilderDelegate has childCount, SliverList is valid, and Text is allowed inside delegate.

3. Final Answer:

   Using children instead of slivers property in CustomScrollView. -> Option C

4. Quick Check:

   CustomScrollView uses slivers, not children [OK]

Hint: CustomScrollView needs slivers: [], not children: [] [OK]

Common Mistakes:

• Using children property instead of slivers
• Confusing SliverList with ListView
• Thinking Text widget is invalid inside SliverChildBuilderDelegate

5. You want to create a scrollable screen with a header that shrinks on scroll, a grid of images, and a list of text items below. Which combination of slivers inside a CustomScrollView will achieve this?

hard

A. SliverAppBar (with flexibleSpace), SliverGrid, SliverList

B. SliverPersistentHeader, ListView, GridView

C. AppBar, GridView.builder, ListView.builder

D. SliverToBoxAdapter, SliverFixedExtentList, SliverFillRemaining

Solution

1. Step 1: Identify slivers for header, grid, and list

   SliverAppBar with flexibleSpace creates a shrinking header. SliverGrid shows a grid of items. SliverList shows a scrollable list.

2. Step 2: Check options for correct sliver usage

   SliverAppBar (with flexibleSpace), SliverGrid, SliverList uses all correct slivers inside CustomScrollView. Others mix non-sliver widgets or incorrect combinations.

3. Final Answer:

   SliverAppBar (with flexibleSpace), SliverGrid, SliverList -> Option A

4. Quick Check:

   Header + grid + list = SliverAppBar + SliverGrid + SliverList [OK]

Hint: Use SliverAppBar for header, SliverGrid for grid, SliverList for list [OK]

Common Mistakes:

• Using ListView/GridView inside CustomScrollView slivers
• Not using SliverAppBar for shrinking header
• Confusing SliverPersistentHeader with SliverAppBar