Wrap widget in Flutter - Mini App: Build & Ship

Build: Wrap Widget Demo

This screen shows a list of colored boxes arranged using the Wrap widget. The boxes automatically move to the next line when they don't fit horizontally.

Target UI

Wrap Widget Demo

[Red] [Green] [Blue] [Yellow]
[Orange] [Purple] [Pink] [Brown]

The boxes wrap to next line if needed.

Use a Wrap widget to arrange colored boxes horizontally.

Each box should be a square with a fixed size and a distinct color.

Boxes should wrap to the next line automatically when they reach the screen edge.

Add spacing of 8 pixels between boxes horizontally and vertically.

Starter Code

Flutter

import 'package:flutter/material.dart';

class WrapWidgetDemo extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Wrap Widget Demo')),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: // TODO: Add Wrap widget here
      ),
    );
  }
}

Task 1

Task 2

Task 3

Solution

Flutter

import 'package:flutter/material.dart';

class WrapWidgetDemo extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Wrap Widget Demo')),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Wrap(
          spacing: 8.0,
          runSpacing: 8.0,
          children: [
            Container(width: 60, height: 60, color: Colors.red),
            Container(width: 60, height: 60, color: Colors.green),
            Container(width: 60, height: 60, color: Colors.blue),
            Container(width: 60, height: 60, color: Colors.yellow),
            Container(width: 60, height: 60, color: Colors.orange),
            Container(width: 60, height: 60, color: Colors.purple),
            Container(width: 60, height: 60, color: Colors.pink),
            Container(width: 60, height: 60, color: Colors.brown),
          ],
        ),
      ),
    );
  }
}

We use the Wrap widget to arrange boxes horizontally and wrap them to the next line when needed. The spacing property adds horizontal space between boxes, and runSpacing adds vertical space between lines. Each Container is a colored square of 60x60 pixels. This layout adapts nicely to different screen widths.

Final Result

Completed Screen

Wrap Widget Demo

[■ Red] [■ Green] [■ Blue] [■ Yellow]
[■ Orange] [■ Purple] [■ Pink] [■ Brown]

Boxes are arranged horizontally and wrap to next line if screen is narrow.

No scrolling needed; layout adjusts automatically.

Stretch Goal

Add a toggle button in the AppBar to switch between horizontal Wrap and vertical Wrap (direction change).

💡 Hint

Use a StatefulWidget and change the Wrap's direction property between Axis.horizontal and Axis.vertical when the button is pressed.

Practice

1. What is the main purpose of the Wrap widget in Flutter?

easy

A. To arrange child widgets in lines and wrap them when space runs out

B. To create a scrollable list of items vertically

C. To stack widgets on top of each other

D. To display a single widget centered on the screen

Solution

1. Step 1: Understand Wrap widget behavior

   The Wrap widget arranges children in horizontal or vertical lines and wraps them to the next line when there is no more space.

2. Step 2: Compare options with Wrap's purpose

   Only To arrange child widgets in lines and wrap them when space runs out describes this behavior correctly. Options A, B, and C describe other widgets or layouts.

3. Final Answer:

   To arrange child widgets in lines and wrap them when space runs out -> Option A

4. Quick Check:

   Wrap = arrange and wrap children [OK]

Hint: Wrap arranges children and moves to next line when needed [OK]

Common Mistakes:

• Confusing Wrap with ListView (scrollable list)
• Thinking Wrap stacks widgets like Stack widget
• Assuming Wrap centers a single widget

2. Which of the following is the correct syntax to create a Wrap widget with spacing of 10 pixels between children?

easy

A. Wrap(childSpacing: 10, children: [Text('A'), Text('B')])

B. Wrap(space: 10, children: [Text('A'), Text('B')])

C. Wrap(padding: 10, children: [Text('A'), Text('B')])

D. Wrap(spacing: 10, children: [Text('A'), Text('B')])

Solution

1. Step 1: Identify the correct property for spacing

   The Wrap widget uses the property spacing to set horizontal gaps between children.

2. Step 2: Check the options for correct property name

   Only Wrap(spacing: 10, children: [Text('A'), Text('B')]) uses spacing correctly. Options A, B, and D use incorrect property names.

3. Final Answer:

   Wrap(spacing: 10, children: [Text('A'), Text('B')]) -> Option D

4. Quick Check:

   Spacing property = spacing [OK]

Hint: Use 'spacing' property for gaps between children in Wrap [OK]

Common Mistakes:

• Using 'space' or 'childSpacing' instead of 'spacing'
• Confusing padding with spacing
• Omitting the children list

3. What will be the visual output of this Flutter code snippet?

Wrap(
  spacing: 8,
  runSpacing: 12,
  children: [
    Container(width: 100, height: 50, color: Colors.red),
    Container(width: 100, height: 50, color: Colors.green),
    Container(width: 100, height: 50, color: Colors.blue),
    Container(width: 100, height: 50, color: Colors.yellow),
  ],
)

Assuming the screen width is 220 pixels.

medium

A. Two rows: first row with 2 containers, second row with 2 containers, with 8px horizontal and 12px vertical spacing

B. One row with all 4 containers side by side with 8px spacing

C. Four rows with one container each stacked vertically

D. Two rows: first row with 3 containers, second row with 1 container, no spacing

Solution

1. Step 1: Calculate how many containers fit per row

   Each container is 100px wide, spacing between is 8px. Two containers plus spacing: 100 + 8 + 100 = 208px, which fits in 220px width. Three containers would be 100 + 8 + 100 + 8 + 100 = 316px, too wide.

2. Step 2: Determine rows and spacing

   So, Wrap places 2 containers in first row, then wraps to second row for next 2 containers. Horizontal spacing is 8px, vertical runSpacing is 12px.

3. Final Answer:

   Two rows: first row with 2 containers, second row with 2 containers, with 8px horizontal and 12px vertical spacing -> Option A

4. Quick Check:

   Wrap fits 2 per row with spacing [OK]

Hint: Add widths plus spacing to check fit per row [OK]

Common Mistakes:

• Assuming all containers fit in one row
• Ignoring spacing when calculating width
• Confusing runSpacing with spacing

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

Wrap(
  spacing: 10,
  children: [
    Text('One'),
    Text('Two'),
    Text('Three'),
  ],
  runSpacing: 15
)

medium

A. The spacing property must be inside children

B. The children list is missing a closing bracket

C. There is no error; the code is correct

D. The runSpacing property is placed after children, causing a syntax error

Solution

1. Step 1: Check property order in Wrap widget

   In Flutter, the order of named parameters does not matter. runSpacing can be placed after children without error.

2. Step 2: Verify brackets and property usage

   The children list is properly closed, and spacing is correctly used as a property, not inside children.

3. Final Answer:

   There is no error; the code is correct -> Option C

4. Quick Check:

   Named parameters order doesn't cause errors [OK]

Hint: Named parameters order doesn't matter in Flutter [OK]

Common Mistakes:

• Thinking property order causes syntax errors
• Misreading brackets in children list
• Confusing property placement inside children

5. You want to create a responsive tag list using Wrap that automatically moves tags to the next line when they don't fit horizontally. Which combination of properties should you set to control the horizontal space between tags and vertical space between lines?

hard

A. Use padding for horizontal gaps and margin for vertical gaps

B. Use spacing for horizontal gaps and runSpacing for vertical gaps

C. Use mainAxisSpacing for horizontal gaps and crossAxisSpacing for vertical gaps

D. Use horizontalSpacing for horizontal gaps and verticalSpacing for vertical gaps

Solution

1. Step 1: Identify correct properties for Wrap spacing

   The Wrap widget uses spacing to set horizontal gaps between children and runSpacing to set vertical gaps between lines.

2. Step 2: Eliminate incorrect property names

   Properties like padding, margin, mainAxisSpacing, crossAxisSpacing, horizontalSpacing, and verticalSpacing are not valid for Wrap.

3. Final Answer:

   Use spacing for horizontal gaps and runSpacing for vertical gaps -> Option B

4. Quick Check:

   Wrap spacing = spacing and runSpacing [OK]

Hint: Remember: spacing = horizontal, runSpacing = vertical [OK]

Common Mistakes:

• Using padding or margin instead of spacing properties
• Confusing Wrap with GridView spacing properties
• Using incorrect property names like mainAxisSpacing