You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/ff-concepts/animations/widget_animations.md
+29-18Lines changed: 29 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,29 +3,24 @@ title: Widget Amimations
3
3
sidebar_position: 1
4
4
---
5
5
import slideGif from '@site/static/img/animations/animation_gifs/fade.gif';
6
+
import animationsOverview from '@site/static/img/animations/animations_overview.png';
7
+
import shimmerAnimationFinal from '@site/static/img/animations/shimmer_animation_final.gif';
6
8
7
9
8
10
9
-
Widget animations allow you to animate an entire widget.
10
-
11
-
<!-- <gif> -->
12
-
13
-
## Applying widget animations
11
+
Widget animations allow you to add animation effects at the widget level.
14
12
To add an animation to a widget, you'll need to go to the property panel for the widget and select the animations tab.
15
13
16
-
Widget animations can be triggered when the page (or widget) is loaded, or can be triggered as an action.
17
-
14
+
<imgsrc={animationsOverview}class="small-image"alt="Animation tab within the property panel is used to add widget animations. Animation trigger specifies when the animation will be run. Widget animations can be triggered when the page (or widget in the case of a delayed load) loaded, or within an action. Animation effect specifies the type of animation to use.Animation curve specifies the function used to interpolate values over time. It controls the speed and style of the animation. Animation properties specifies the properties that can be configured for all widget animations, like whether or not it should loop. Effect-specific properties are properties to specific to the animation effect selected. For example, Fade animations allow you to control the initial opacity and the final opacity. You can customize these values to get the look and feel you desire." />
18
15
19
-
<!-- TO DO anotated screenshot -->
20
-
21
-
When you create a widget animation, you'll sepcify:
16
+
<!-- When you create a widget animation, you'll sepcify:
22
17
23
18
- The animation effect
24
19
- The animation's curve
25
-
- Any variables specific to the animation
20
+
- Any variables specific to the animation-->
26
21
27
22
## Types of widget animation effects
28
-
FlutterFlow supports a variety of animation effects
23
+
FlutterFlow supports a variety of animation effects.
29
24
30
25
| Animation Effect | Description | Example |
31
26
| ----- | ----- | ----- |
@@ -42,18 +37,34 @@ FlutterFlow supports a variety of animation effects
42
37
|**Tint**| Creates a color changing effect on a widget |<imgsrc={slideGif}class="xsmall-image"alt="Alt text for your GIF" /> |
43
38
44
39
## Types of widget animation curves
40
+
When applying an animation, you'll also be able to specify the curve. An animation curve is essentially a mathematical formula used to interoplate values over time. Changing the animation curve allows you to control the speed and style of the animation.
41
+
42
+
FlutterFlow supports a variety of animation effects
43
+
44
+
| Animation Curve | Description | Example |
45
+
| ----- | ----- | ----- |
46
+
|**Ease In**|| <imgsrc={slideGif}class="xsmall-image"alt="Alt text for your GIF" />|
47
+
|**Ease In Out**|| <imgsrc={slideGif}class="xsmall-image"alt="Alt text for your GIF" />|
48
+
|**Ease Out**|| <imgsrc={slideGif}class="xsmall-image"alt="Alt text for your GIF" />|
49
+
|**Bounce**|| <imgsrc={slideGif}class="xsmall-image"alt="Alt text for your GIF" />|
50
+
|**Elastic**|| <imgsrc={slideGif}class="xsmall-image"alt="Alt text for your GIF" />|
51
+
|**Linear**|| <imgsrc={slideGif}class="xsmall-image"alt="Alt text for your GIF" />|
52
+
53
+
54
+
## Triggering an animation on page load
55
+
There are many cases when you might want to trigger an animation when a page or (in the case of a delayed load) widget is loaded onto the screen.
56
+
57
+
Consider an eCommerce use case, where a backend query is used retrieve a list of trending products. There may be some delay between when the page is first loaded and when the actual results are displayed. To improve the user experience we can add some animations to let users know when content is loading, and smoothly transition between a loading widget and a widget that displays the retreived content.
45
58
59
+
<imgsrc={shimmerAnimationFinal}class="small-image"alt="A widget that first shows a container with a shimmer effect, then fades in a widget displaying the product details" />
46
60
61
+
To create an experience like this, we need to:
47
62
48
-
## Triggering an animation on page (or widget) load
49
-
There are many cases when you might want to trigger an animation when a page or widget is loaded onto the screen.
63
+
1. Add a shimmer animation to a widget, and display that widget when the query is loading.
50
64
51
-
Consider an eCommerce use case, where a backend query is used retrieve a list of trending products. There may be some delay between when the page is first loaded and when the actual results are displayed. To improve the user experience we can:
52
65
53
-
1. Add a shimmer animation to a widget displayed when the query is still loading
54
-
2. Add a fade animation to make the product details widget fade into view
66
+
2. Add a fade animation to the widget that displays the query result, to gradually present it on the screen.
55
67
56
-
<!-- Add arcade -->
57
68
58
69
59
70
## Triggering an animation as part of an action flow
0 commit comments