As UI developers, you often need to show and hide elements on screen. However,quickly popping elements on and off the screen can feel jarring to end users.Instead, you can fade elements in and out with an opacity animation to createa smooth experience.

In Flutter, you can achieve this task using the AnimatedOpacity Widget.

Directions

  • Show a box to fade in and out
  • Define a StatefulWidget
  • Display a button that toggles the visibility
  • Fade the box in and out

1. Create a box to fade in and out

First, you’ll need something to fade in and out. In this example,you’ll draw a green box on screen.

  1. Container(
  2. width: 200.0,
  3. height: 200.0,
  4. color: Colors.green,
  5. );

2. Define a StatefulWidget

Now that you have a green box to animate, you’ll need a way to know whether thebox should be visible or invisible. To accomplish this, use aStatefulWidget.

A StatefulWidget is a class that creates a State object. The State objectholds some data about our app and provides a way to update that data. When youupdate the data, you can also ask Flutter to rebuild our UI with those changes.

In this case, you’ll have one piece of data: a boolean representing whether thebutton is visible or invisible.

To construct a StatefulWidget, you need to create two classes: AStatefulWidget and a corresponding State class. Pro tip: The Flutter pluginsfor Android Studio and VSCode include the stful snippet to quickly generatethis code.

  1. // The StatefulWidget's job is to take in some data and create a State class.
  2. // In this case, our Widget takes in a title, and creates a _MyHomePageState.
  3. class MyHomePage extends StatefulWidget {
  4. final String title;
  5. MyHomePage({Key key, this.title}) : super(key: key);
  6. @override
  7. _MyHomePageState createState() => _MyHomePageState();
  8. }
  9. // The State class is responsible for two things: holding some data you can
  10. // update and building the UI using that data.
  11. class _MyHomePageState extends State<MyHomePage> {
  12. // Whether the green box should be visible or invisible
  13. bool _visible = true;
  14. @override
  15. Widget build(BuildContext context) {
  16. // The green box goes here with some other Widgets.
  17. }
  18. }

3. Display a button that toggles the visibility

Now that you have some data to determine whether the green box should be visibleor invisible, you’ll need a way update that data. In this case, if the box isvisible, you want to hide it. If the box is hidden, you want to show it.

To achieve this, you’ll display a button. When a user presses the button, you’llflip the boolean from true to false, or false to true. You need to make thischange using setState, which is a method on the State class.This lets Flutter know it needs to rebuild the Widget.

Note: For more information on working with user input, please see theGestures section of the Cookbook.

  1. FloatingActionButton(
  2. onPressed: () {
  3. // Make sure to call setState. This tells Flutter to rebuild the
  4. // UI with the changes.
  5. setState(() {
  6. _visible = !_visible;
  7. });
  8. },
  9. tooltip: 'Toggle Opacity',
  10. child: Icon(Icons.flip),
  11. );

4. Fade the box in and out

You’ve got a green box on screen. You’ve got a button to toggle the visibilityto true or false. So how do you fade the box in and out? With anAnimatedOpacity Widget.

The AnimatedOpacity Widget requires three arguments:

  • opacity: A value from 0.0 (invisible) to 1.0 (fully visible).
  • duration: How long the animation should take to complete.
  • child: The Widget to animate. In our case, the green box.
  1. AnimatedOpacity(
  2. // If the Widget should be visible, animate to 1.0 (fully visible). If
  3. // the Widget should be hidden, animate to 0.0 (invisible).
  4. opacity: _visible ? 1.0 : 0.0,
  5. duration: Duration(milliseconds: 500),
  6. // The green box needs to be the child of the AnimatedOpacity
  7. child: Container(
  8. width: 200.0,
  9. height: 200.0,
  10. color: Colors.green,
  11. ),
  12. );

Complete example

  1. import 'package:flutter/material.dart';
  2. void main() => runApp(MyApp());
  3. class MyApp extends StatelessWidget {
  4. @override
  5. Widget build(BuildContext context) {
  6. final appTitle = 'Opacity Demo';
  7. return MaterialApp(
  8. title: appTitle,
  9. home: MyHomePage(title: appTitle),
  10. );
  11. }
  12. }
  13. // The StatefulWidget's job is to take in some data and create a State class.
  14. // In this case, the Widget takes a title, and creates a _MyHomePageState.
  15. class MyHomePage extends StatefulWidget {
  16. final String title;
  17. MyHomePage({Key key, this.title}) : super(key: key);
  18. @override
  19. _MyHomePageState createState() => _MyHomePageState();
  20. }
  21. // The State class is responsible for two things: holding some data you can
  22. // update and building the UI using that data.
  23. class _MyHomePageState extends State<MyHomePage> {
  24. // Whether the green box should be visible or invisible
  25. bool _visible = true;
  26. @override
  27. Widget build(BuildContext context) {
  28. return Scaffold(
  29. appBar: AppBar(
  30. title: Text(widget.title),
  31. ),
  32. body: Center(
  33. child: AnimatedOpacity(
  34. // If the Widget should be visible, animate to 1.0 (fully visible).
  35. // If the Widget should be hidden, animate to 0.0 (invisible).
  36. opacity: _visible ? 1.0 : 0.0,
  37. duration: Duration(milliseconds: 500),
  38. // The green box needs to be the child of the AnimatedOpacity
  39. child: Container(
  40. width: 200.0,
  41. height: 200.0,
  42. color: Colors.green,
  43. ),
  44. ),
  45. ),
  46. floatingActionButton: FloatingActionButton(
  47. onPressed: () {
  48. // Make sure to call setState. This tells Flutter to rebuild the
  49. // UI with the changes.
  50. setState(() {
  51. _visible = !_visible;
  52. });
  53. },
  54. tooltip: 'Toggle Opacity',
  55. child: Icon(Icons.flip),
  56. ), // This trailing comma makes auto-formatting nicer for build methods.
  57. );
  58. }
  59. }

Fade In and Out Demo