AnimatedBuilder in Flutter

Introduction

AnimatedBuilder helps you create smooth animations by rebuilding only parts of your UI that change. It makes animations efficient and easy to manage.

When you want to animate a widget smoothly without rebuilding the whole screen.

When you have a complex widget tree but only a small part needs to animate.

When you want to separate animation logic from UI code for cleaner design.

When you want to reuse the same animation for multiple widgets.

When you want to improve app performance during animations.

Syntax

Flutter

AnimatedBuilder(
  animation: animationController,
  builder: (context, child) {
    return Transform.rotate(
      angle: animationController.value * 2 * 3.141592653589793,
      child: child,
    );
  },
  child: YourWidget(),
)

animation: The animation object that controls the animation progress.

builder: A function that rebuilds the widget tree when the animation changes. It receives the current context and a child widget.

child: The widget that does not change during animation, passed to builder for efficiency.

Examples

This example animates the opacity of a Text widget from transparent to visible.

Flutter

AnimatedBuilder(
  animation: controller,
  builder: (context, child) {
    return Opacity(
      opacity: controller.value,
      child: child,
    );
  },
  child: Text('Fade In'),
)

This example scales an icon up and down smoothly.

Flutter

AnimatedBuilder(
  animation: controller,
  builder: (context, child) {
    return Transform.scale(
      scale: controller.value,
      child: child,
    );
  },
  child: Icon(Icons.star, size: 50),
)

Sample App

This app shows a blue square with the word "Rotate" that continuously spins in a circle using AnimatedBuilder.

Flutter

import 'package:flutter/material.dart';

void main() => runApp(const MyApp());

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

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> with SingleTickerProviderStateMixin {
  late final AnimationController _controller;

  @override
  void initState() {
    super.initState();
    _controller = AnimationController(
      duration: const Duration(seconds: 3),
      vsync: this,
    )..repeat();
  }

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('AnimatedBuilder Example')),
        body: Center(
          child: AnimatedBuilder(
            animation: _controller,
            builder: (context, child) {
              return Transform.rotate(
                angle: _controller.value * 2 * 3.141592653589793,
                child: child,
              );
            },
            child: Container(
              width: 100,
              height: 100,
              color: Colors.blue,
              child: const Center(
                child: Text('Rotate', style: TextStyle(color: Colors.white)),
              ),
            ),
          ),
        ),
      ),
    );
  }
}

Important Notes

Use the child parameter to pass widgets that do not change during animation to improve performance.

AnimatedBuilder rebuilds only the widgets inside the builder function, not the entire widget tree.

Always dispose your AnimationController to free resources.

Summary

AnimatedBuilder helps animate parts of your UI efficiently.

Use animation, builder, and child to control what changes and what stays the same.

It improves performance by rebuilding only necessary widgets during animation.

Practice

1. What is the main purpose of using AnimatedBuilder in Flutter?

easy

A. To handle user input events

B. To create static UI elements without animation

C. To efficiently rebuild only parts of the UI that change during animation

D. To manage app navigation between screens

Solution

1. Step 1: Understand AnimatedBuilder's role

   AnimatedBuilder is designed to rebuild only the widgets that depend on the animation value, improving performance.

2. Step 2: Compare with other options

   Options B, C, and D describe unrelated Flutter features like static UI, input handling, and navigation.

3. Final Answer:

   To efficiently rebuild only parts of the UI that change during animation -> Option C

4. Quick Check:

   AnimatedBuilder optimizes UI updates = A [OK]

Hint: AnimatedBuilder rebuilds only animated parts [OK]

Common Mistakes:

• Thinking AnimatedBuilder rebuilds the whole UI
• Confusing AnimatedBuilder with navigation widgets
• Assuming it handles user input

2. Which of the following is the correct way to declare an AnimatedBuilder widget?

easy

A. AnimatedBuilder(animation: builder, child: myAnimation, builder: context)

B. AnimatedBuilder(child: myAnimation, animation: builder, builder: childWidget)

C. AnimatedBuilder(builder: myAnimation, animation: childWidget, child: context)

D. AnimatedBuilder(animation: myAnimation, builder: (context, child) => Widget, child: childWidget)

Solution

1. Step 1: Recall AnimatedBuilder parameters

   AnimatedBuilder requires an animation, a builder function with context and child, and optionally a child widget.

2. Step 2: Match correct parameter order and names

   AnimatedBuilder(animation: myAnimation, builder: (context, child) => Widget, child: childWidget) correctly uses animation, builder, and child parameters in proper order and types.

3. Final Answer:

   AnimatedBuilder(animation: myAnimation, builder: (context, child) => Widget, child: childWidget) -> Option D

4. Quick Check:

   Correct parameter names and order = D [OK]

Hint: Remember: animation, builder, then child parameters [OK]

Common Mistakes:

• Mixing parameter names and order
• Passing wrong types to parameters
• Confusing builder and child roles

3. Given this Flutter code snippet using AnimatedBuilder:

AnimatedBuilder(
  animation: animationController,
  builder: (context, child) {
    return Opacity(
      opacity: animationController.value,
      child: child,
    );
  },
  child: const Text('Hello'),
)

What will be the visible effect when the animation runs from 0 to 1?

medium

A. The text 'Hello' fades in from invisible to fully visible

B. The text 'Hello' moves from left to right

C. The text 'Hello' changes color gradually

D. The text 'Hello' scales up in size

Solution

1. Step 1: Analyze the builder function

   The builder returns an Opacity widget with opacity set to animationController.value, which changes from 0 to 1.

2. Step 2: Understand the effect on child

   The child is the Text widget 'Hello'. Opacity changes from transparent (0) to fully visible (1), causing a fade-in effect.

3. Final Answer:

   The text 'Hello' fades in from invisible to fully visible -> Option A

4. Quick Check:

   Opacity animation from 0 to 1 = fade-in [OK]

Hint: Opacity from 0 to 1 means fade-in effect [OK]

Common Mistakes:

• Confusing opacity with movement or color
• Ignoring the child parameter usage
• Assuming scaling instead of opacity change

4. What is wrong with this AnimatedBuilder usage?

AnimatedBuilder(
  animation: animationController,
  builder: (context) {
    return Transform.rotate(
      angle: animationController.value,
      child: Text('Rotate'),
    );
  },
)

medium

A. The builder function is missing the child parameter

B. The animationController.value cannot be used as an angle

C. Text widget cannot be used inside AnimatedBuilder

D. Transform.rotate requires a duration parameter

Solution

1. Step 1: Check builder function signature

   The builder function must accept two parameters: context and child, but here it only has context.

2. Step 2: Understand AnimatedBuilder usage

   Missing the child parameter can cause unnecessary rebuilds and is against the recommended pattern.

3. Final Answer:

   The builder function is missing the child parameter -> Option A

4. Quick Check:

   Builder needs (context, child) parameters [OK]

Hint: Builder must have (context, child) parameters [OK]

Common Mistakes:

• Omitting the child parameter in builder
• Misusing animation value types
• Thinking Transform.rotate needs duration

5. You want to animate a widget's size smoothly using AnimatedBuilder with a Tween from 100 to 200 pixels. Which approach correctly optimizes performance by avoiding rebuilding the static child widget?

hard

A. Use setState inside the builder to update the child widget size

B. Pass the static child widget as the child parameter and use it inside the builder without rebuilding

C. Create the child widget inside the builder function every time it rebuilds

D. Wrap the child widget with a StatefulWidget and rebuild it manually

Solution

1. Step 1: Understand AnimatedBuilder optimization

   Passing the static child widget as the child parameter prevents it from rebuilding on every animation tick.

2. Step 2: Avoid rebuilding static widgets inside builder

   Creating the child inside builder causes unnecessary rebuilds, hurting performance.

3. Final Answer:

   Pass the static child widget as the child parameter and use it inside the builder without rebuilding -> Option B

4. Quick Check:

   Use child parameter to optimize rebuilds = C [OK]

Hint: Use child parameter to avoid rebuilding static widgets [OK]

Common Mistakes:

• Building static widgets inside builder repeatedly
• Using setState inside builder incorrectly
• Misunderstanding child parameter purpose