Using Animations

Animated style changes can also be applied to some parts of your app’s UI to provide smoother ways to transition from one section to the other or to generate a more engaging app interaction by making and animating your own custom UI elements.

Web Controls and Web Pages that allow animation will have an Animations section in their associated Inspector.

Animating Page Transitions

Away to include this feature to your app is by animating the transitions from Web Page to Web Page.

  1. In Web Flows Builder, select the first Web Page and go to the General tab of the Inspector.
  2. In Animations > Entering Page Transitions you can choose whether to add an entering or an exiting page transition.
  3. Select one of the available transition options, for example Slide left.

  1. Go to App Preview to see how the first Web Page slides left after clicking on the button that takes the user to the next Web Page.
    GIF

Repeat the process in all Web Pages you wish to add an animated transition into or out of other Web Pages.

Animated Progress Bar (Advanced)

We can also use Animations to create custom UI components. To do this, some familiarity with Airscript is required, as we’ll be working with User Defined Functions.

Let's add to our Info form Web Page an animated Progress Bar to indicate the user how far into completing the form they are.

Bear in mind that in this case we’ll be creating a custom animated progress bar from scratch based on user input. Unlike adding the Progress Bar that Airkit provides as a Web Control, we’ll be customizing all aspects of its appearance.

  1. In Web Flows Builder, select the Info form page.
  2. Add a Container and rename it to “Progress Bar Container”.

  1. Drag and drop it just above the Action Container.

Since this Container will hold the Progress Bar, let’s make sure it has a set height so that it doesn’t disappear when there are no Web Controls in it.

  1. Go to Override Styles > Dimensions and, in Height, enter “50px” in the Expression editor as a hardcoded standard:

  1. In Override Style > Background, change its color. This will be the color that will show before the user enters their information. In this case, we are using a lighter blue shade.

  1. Nest a Container underneath the Progress Bar Container and rename it to “Progress Bar”.

  1. Go to Override Styles > Dimensions and, in Height, enter “50px” in the Expression editor as a hardcoded standard to match the holding Container. Also, pick a contrasting background color.

Once these Web Controls are set, we're going to animate changes to the progress bar's width. To configure that, let’s create a Variable to define that width.

  1. Go to Variables Tree and add a Variable of type Number at the Activity level. Select the corresponding Web Page and change its name to bar_filled.

  1. For testing purposes, let’s add “50” as a value.

  1. With the inner Progress Bar Control selected, go to Override Styles > Dimensions and, under Width, enter the following Expression.
"{{FORMAT_NUMBER(activity.bar_filled, "")}}%"
 
  1. Save the app and and note how this will change the appearance of the Containers in the Stage so that a portion of the Progress Bar Container is visible:

By using the FORMAT_NUMBER function to set the width of the progress bar, the appearance of the UI in the Stage changes according to the Variable in the Tree.

  1. Go to Animations > Transitions, select Dimensions and assign it a time. In this case, we are choosing TimingSlow to better appreciate the transition.

Configuring the progress bar with Airscript

Now we need to change the value of activity.bar_filled to reflect what percentage of the form has been filled out. To do so, we will create a User Defined Function.

  1. Go to Connections Builder and click on the ‘+’ sign next to User Defined Functions.
  2. In the Inspector, add the following Variables:
    a. Of type Text: first_name_value and last_name_value
    b. Of type Phone: phone_value
    c. Of type Email: email_value

Next, we’ll create a condition to see how many of the input Values are TRUE and how many are FALSE. To do so, we’ll use the IF and ISNOTEMPTY functions combined to get the summation. Considering that we have four fields, a percentage of 25 will be assigned to each. Therefore, for each field that is not empty, 25% of the bar will be filled and for each field that is empty, 0% of the bar will be filled.

  1. In Function Body, add the following summation of all Variables:
IF(ISNOTEMPTY(first_name_value), 25, 0)
+IF(ISNOTEMPTY(last_name_value), 25, 0)
+IF(ISNOTEMPTY(phone_value), 25, 0)
+IF(ISNOTEMPTY(email_value), 25, 0)

  1. In the Inspector, go to User > Namespace and name this function:

Checking against the fields

  1. Go to Web Flows Builder and select the Info form Web Page.
  2. Go to the Actions tab of the Inspector and on Web Page Viewed add a Set Variable Action.
  3. Complete it with the activity.bar_filled Variable and set the initial Value to “0” so when a user first navigates the Web Page the progress bar is empty.

Then we’ll add an Action to each of the Input fields for when information is entered.

  1. Select the customer.first_name Input field and go to the Actions tab of the Inspector.
  2. In On Blur, add a Set Variable Action. Complete it with activity.bar_filled as the Variable and the User Defined Function as the Value. This way, the User Defined Function checks against the four Input Controls whether they are filled or empty. As information is entered in the customer.first_name field, and the other three remain empty, the User Defined Function will only fill a quarter of the progress bar.
how_filled#USER_FUNCTION(  
  customer.first_name,  
  customer.last_name,  
  customer.phone,  
  customer.email  
)

  1. Repeat the process of adding the Set Variable action with the same Variable and Value on the other three Input fields so that the same function runs each time the user completes a field.

📘

For the customer.phone and customer.email fields, we recommend adding this Set Variable action in Value Change as these fields count on their own validation and this way we are making sure the user entered a valid phone and email before summiting the form.

Previewing the Progress Bar

  1. Go to App Preview.
  2. Start completing the fields and check how the progress bar will load on quarters. If an inputted value is erased, the progress bar will go back to the previous porcentage.