HowTo: Include animations in Native Mobile and Angular apps

GeneXus allows integrating animations when developing applications, more specifically, Lottie animations.

Lottie is an animation library created by Airbnb. It is highly flexible, allows creating any kind of animations, uses small files, and provides a JSON API to integrate the animations into mobile applications. With these JSON files, you can include the animations in a GeneXus Knowledge Base. Many design software tools provide export capabilities to Lottie JSON format files. In addition, there are several animation repositories (like Lottie Files) with many animations in JSON files that can be downloaded.

Steps to add animations to the KB

To include the animations in the Knowledge Base, you need to do two things:

1. Add the Lottie JSON files as a File object in the Knowledge Base.

To create a File object, select in the main GeneXus Menu: File > New > Object and a New object dialog will be displayed. Select File object from the list.

2. Create Animation classes with Design System Object.

In Design System objects, you can create a class to add your animations to an application. 

For example: the class called “Animation” where you set the Animation type, in this case, Lottie Animation Type.

.Animation
{
    gx-animation-type: idLottie;
}

.LoadingAnimation
{
    @include Animation;
    gx-lottie-file: gx-file(LottieAnimationLoading);
}

And a “LoadingAnimation” class that contains the “Animation” class and declares the jsonFile you want to add to your application.

After the Design system classes are created, the animation is ready to be included in the application.

Including the animation in the application

Now that the animations are included in the KB, you can integrate them into the application. There are four ways to make this integration:

1. Animation View User Control

With the Animation View User Control, an animation can be included on any screen of an application. The control provides methods that allow setting the animation and managing its execution and progress.

Event ClientStart
   Composite
      AnimationView1.SetAnimation("LoadingAnimation", true)
      AnimationView1.Play()
   EndComposite
Endevent

Event 'PauseAnimation'
   AnimationView1.Pause()
EndEvent

Event 'SetProgress'
   Composite
      &Progress = 0.5
      AnimationView1.SetProgress(&Progress)
   EndComposite
EndEvent

2. Customizing the loading of forms and grids

It is possible to use animations to customize the loading process of object forms and grids. That is, you can replace the usual loading circle with a more sophisticated Lottie animation.

To do this, there is a property that can be set in the Styles section of a Design System Object, named gx-loading-animation-class.

The definition is as follows:

.Form

{
      gx-enter-effect: gx_default;
      gx-close-effect: gx_default;
      gx-call-type: gx_default;
      gx-target-size: gx_default;
      gx-target-width: 100%;
      gx-target-height: 100%;
      gx-content-size-change: gx_default;
      gx-input-view-appearance: gx_default;
      gx-loading-animation-class: Animation;
      gx-loading-animation-behavior: platform_default;
}

3. Customizing Progress Indicator controls

An animation can be used to customize a Progress Indicator User Control. To do this, a Progress theme class has to be created and an Animation-type class name set in the Animation Class property of this class. The indicated animation will be displayed when the Progress Indicator User Control is shown.

4. Customizing the Launch Screen

It is possible to use an animation as the Launch Screen of your application. This can be set in the Styles section of a Design System Object.

.Application

{
     gx-background-image-mode: stretch;
     gx-image-loading-indicator: False;
     gx-launch-screen-animation-class: Animation;
}