AnimationController in Flutter

Introduction

An AnimationController lets you create animations by controlling how they start, stop, and change over time.

When you want to animate a widget's size or color smoothly.

When you need to control animation speed or repeat it.

When you want to create custom animations beyond simple built-in ones.

Syntax

Flutter

AnimationController(
  vsync: this,
  duration: const Duration(seconds: 1),
);

vsync helps the animation run efficiently by syncing with the screen refresh.

duration sets how long the animation lasts.

Examples

Animation that lasts half a second.

Flutter

AnimationController(
  vsync: this,
  duration: const Duration(milliseconds: 500),
);

Animation that goes forward in 2 seconds and reverses in 1 second.

Flutter

AnimationController(
  vsync: this,
  duration: const Duration(seconds: 2),
  reverseDuration: const Duration(seconds: 1),
);

Sample App

This example creates a blue square that fades in and out continuously using AnimationController.

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 const MaterialApp(
      home: Scaffold(
        body: Center(
          child: SimpleAnimation(),
        ),
      ),
    );
  }
}

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

  @override
  State<SimpleAnimation> createState() => _SimpleAnimationState();
}

class _SimpleAnimationState extends State<SimpleAnimation> with SingleTickerProviderStateMixin {
  late final AnimationController _controller;

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

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

  @override
  Widget build(BuildContext context) {
    return AnimatedBuilder(
      animation: _controller,
      builder: (context, child) {
        return Opacity(
          opacity: _controller.value,
          child: Container(
            width: 200,
            height: 200,
            color: Colors.blue,
          ),
        );
      },
    );
  }
}

Important Notes

Always dispose your AnimationController in the dispose() method to free resources.

Use SingleTickerProviderStateMixin to provide vsync for one AnimationController.

You can control the animation with methods like forward(), reverse(), and repeat().

Summary

AnimationController controls animation timing and progress.

It needs a vsync provider and a duration.

Dispose it properly to avoid memory leaks.

Practice

1. What is the primary role of an AnimationController in Flutter animations?

easy

A. To handle user input events

B. To display images on the screen

C. To control the timing and progress of an animation

D. To manage network requests

Solution

1. Step 1: Understand AnimationController purpose

   The AnimationController is designed to manage animation timing and progress in Flutter.

2. Step 2: Compare with other options

   Displaying images, handling user input events, and managing network requests relate to other Flutter features, not animation control.

3. Final Answer:

   To control the timing and progress of an animation -> Option C

4. Quick Check:

   AnimationController controls animation timing = A [OK]

Hint: AnimationController manages animation progress and timing [OK]

Common Mistakes:

• Confusing AnimationController with UI widgets
• Thinking it handles user input
• Assuming it manages network or data

2. Which of the following is the correct way to create an AnimationController inside a StatefulWidget with a 2-second duration?

easy

A. AnimationController(duration: Duration(seconds: 2))

B. AnimationController(duration: 2, vsync: this)

C. AnimationController(vsync: this, duration: 2)

D. AnimationController(vsync: this, duration: Duration(seconds: 2))

Solution

1. Step 1: Check correct parameter types

   The duration parameter requires a Duration object, and vsync must be provided.

2. Step 2: Validate each option

   AnimationController(vsync: this, duration: Duration(seconds: 2)) correctly uses Duration(seconds: 2) and vsync: this. Constructors passing an integer for duration misuse the type. The constructor with only duration misses vsync.

3. Final Answer:

   AnimationController(vsync: this, duration: Duration(seconds: 2)) -> Option D

4. Quick Check:

   Duration needs Duration object and vsync required = A [OK]

Hint: Duration must be a Duration object; vsync is mandatory [OK]

Common Mistakes:

• Passing integer instead of Duration
• Omitting vsync parameter
• Swapping parameter order incorrectly

3. Given this code snippet inside a StatefulWidget:

late AnimationController controller;

@override
void initState() {
  super.initState();
  controller = AnimationController(vsync: this, duration: Duration(seconds: 1));
  controller.forward();
}

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

What happens when this widget is removed from the screen?

medium

A. The animation stops and resources are freed properly

B. The animation continues running in the background

C. The app crashes due to missing dispose call

D. The animation restarts automatically

Solution

1. Step 1: Analyze dispose method

   The dispose() method calls controller.dispose(), which frees animation resources.

2. Step 2: Understand animation lifecycle

   Calling dispose() stops the animation and prevents memory leaks when the widget is removed.

3. Final Answer:

   The animation stops and resources are freed properly -> Option A

4. Quick Check:

   Dispose frees resources and stops animation = B [OK]

Hint: Always dispose AnimationController to stop animation and free memory [OK]

Common Mistakes:

• Forgetting to call dispose causing leaks
• Assuming animation runs after widget removal
• Expecting animation to restart automatically

4. Identify the error in this Flutter code snippet:

class MyWidgetState extends State<MyWidget> with SingleTickerProviderStateMixin {
  late AnimationController controller;

  @override
  void initState() {
    super.initState();
    controller = AnimationController(duration: Duration(seconds: 3));
    controller.forward();
  }

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

medium

A. SingleTickerProviderStateMixin should not be mixed in

B. Missing vsync parameter in AnimationController constructor

C. dispose() method is missing

D. AnimationController duration should be an integer

Solution

1. Step 1: Check AnimationController constructor

   The constructor requires a vsync parameter to optimize animation performance.

2. Step 2: Identify missing parameter

   The code omits vsync: this, causing an error.

3. Final Answer:

   Missing vsync parameter in AnimationController constructor -> Option B

4. Quick Check:

   vsync missing in AnimationController = D [OK]

Hint: AnimationController always needs vsync: this in StatefulWidget [OK]

Common Mistakes:

• Omitting vsync parameter
• Passing wrong type for duration
• Forgetting to mix in SingleTickerProviderStateMixin

5. You want to create a repeating animation that moves a widget back and forth continuously using AnimationController. Which code snippet correctly sets up the controller to repeat the animation forever and reverse direction each time?

hard

A. controller = AnimationController(vsync: this, duration: Duration(seconds: 2))..repeat(reverse: true);

B. controller = AnimationController(vsync: this, duration: Duration(seconds: 2))..forward();

C. controller = AnimationController(vsync: this, duration: Duration(seconds: 2))..repeat();

D. controller = AnimationController(vsync: this, duration: Duration(seconds: 2))..reverse();

Solution

1. Step 1: Understand repeat method parameters

   The repeat() method can take reverse: true to make animation go back and forth.

2. Step 2: Evaluate each option

   controller = AnimationController(vsync: this, duration: Duration(seconds: 2))..repeat(reverse: true); uses repeat(reverse: true) correctly. controller = AnimationController(vsync: this, duration: Duration(seconds: 2))..forward(); only plays forward once. controller = AnimationController(vsync: this, duration: Duration(seconds: 2))..repeat(); repeats but does not reverse. controller = AnimationController(vsync: this, duration: Duration(seconds: 2))..reverse(); calls reverse once, not repeating.

3. Final Answer:

   controller = AnimationController(vsync: this, duration: Duration(seconds: 2))..repeat(reverse: true); -> Option A

4. Quick Check:

   repeat with reverse true = C [OK]

Hint: Use repeat(reverse: true) for back-and-forth animation [OK]

Common Mistakes:

• Using forward() instead of repeat()
• Forgetting reverse: true for back-and-forth
• Calling reverse() once instead of repeating