Animer les changements de mise en page à l'aide d'une transition

Essayer Compose
Jetpack Compose est le kit d'outils d'interface utilisateur recommandé pour Android. Découvrez comment utiliser des animations dans Compose.

Le framework de transition d'Android vous permet d'animer tous types de mouvements dans votre interface utilisateur en fournissant les mises en page de début et de fin. Vous pouvez sélectionner le type d'animation de votre choix, par exemple pour créer ou supprimer des vues en fondu, ou modifier la taille des vues. Le framework de transition détermine ensuite comment l'animer de la mise en page de départ à la mise en page finale.

Le cadre de transition comprend les fonctionnalités suivantes:

  • Animations au niveau du groupe:appliquent des effets d'animation à toutes les vues d'une hiérarchie des vues.
  • Animations intégrées:utilisez des animations prédéfinies pour les effets courants tels que le fondu à la fermeture ou le mouvement.
  • Compatibilité avec les fichiers de ressources:les hiérarchies de chargement des vues et les animations intégrées à partir des fichiers de ressources de mise en page.
  • Rappels de cycle de vie:reçoivent des rappels qui permettent de contrôler l'animation et le processus de changement de hiérarchie.

Pour obtenir un exemple de code qui s'anime entre les modifications de mise en page, consultez BasicTransition.

Le processus de base pour animer entre deux mises en page est le suivant:

  1. Créez un objet Scene pour les mises en page de début et de fin. Cependant, la scène de la mise en page de départ est souvent déterminée automatiquement à partir de la mise en page actuelle.
  2. Créez un objet Transition pour définir le type d'animation souhaité.
  3. Appelez TransitionManager.go(), et le système exécute l'animation pour permuter les mises en page.

Le diagramme de la figure 1 illustre la relation entre vos mises en page, les scènes, la transition et l'animation finale.

Figure 1 : Illustration de base de la façon dont le framework de transition crée une animation.

Créer une scène

Les scènes stockent l'état d'une hiérarchie des vues, y compris toutes ses vues et leurs valeurs de propriété. Le framework de transitions peut exécuter des animations entre une scène de début et une scène de fin.

Vous pouvez créer vos scènes à partir d'un fichier de ressources de mise en page ou d'un groupe de vues dans votre code. Cependant, la scène de départ de votre transition est souvent déterminée automatiquement à partir de l'interface utilisateur actuelle.

Une scène peut également définir ses propres actions, qui sont exécutées lorsque vous en changez. Cette fonctionnalité est utile pour nettoyer les paramètres de vue après la transition vers une scène.

Créer une scène à partir d'une ressource de mise en page

Vous pouvez créer une instance Scene directement à partir d'un fichier de ressources de mise en page. Utilisez cette technique lorsque la hiérarchie des vues dans le fichier est principalement statique. La scène obtenue représente l'état de la hiérarchie des vues au moment de la création de l'instance Scene. Si vous modifiez la hiérarchie des vues, recréez la scène. Le framework crée la scène à partir de l'ensemble de la hiérarchie des vues dans le fichier. Vous ne pouvez pas créer de scène à partir d'une partie d'un fichier de mise en page.

Pour créer une instance Scene à partir d'un fichier de ressources de mise en page, récupérez la racine de la scène à partir de votre mise en page en tant que ViewGroup. Appelez ensuite la fonction Scene.getSceneForLayout() avec la racine de la scène et l'ID de ressource du fichier de mise en page qui contient la hiérarchie des vues de la scène.

Définir des mises en page pour les scènes

Les extraits de code du reste de cette section montrent comment créer deux scènes différentes avec le même élément racine. Les extraits montrent également que vous pouvez charger plusieurs objets Scene non liés sans insinuer qu'ils sont liés les uns aux autres.

L'exemple comprend les définitions de mise en page suivantes:

  • Mise en page principale d'une activité avec une étiquette de texte et un enfant FrameLayout
  • Un élément ConstraintLayout pour la première scène avec deux champs de texte.
  • Une valeur ConstraintLayout pour la deuxième scène avec les deux mêmes champs de texte dans un ordre différent.

L'exemple est conçu de sorte que toute l'animation se produise dans la mise en page enfant de la mise en page principale de l'activité. Dans la mise en page principale, le libellé reste statique.

La mise en page principale de l'activité est définie comme suit:

res/layout/activity_main.xml

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/master_layout">
    <TextView
        android:id="@+id/title"
        ...
        android:text="Title"/>
    <FrameLayout
        android:id="@+id/scene_root">
        <include layout="@layout/a_scene" />
    </FrameLayout>
</LinearLayout>

Cette définition de mise en page contient un champ de texte et un FrameLayout enfant pour la racine de la scène. La mise en page de la première scène est incluse dans le fichier de mise en page principal. Cela permet à l'application de l'afficher dans l'interface utilisateur initiale et de la charger dans une scène, car le framework ne peut charger qu'un fichier de mise en page entier dans une scène.

La mise en page de la première scène est définie comme suit:

res/layout/a_scene.xml

<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/scene_container"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >
    
    
</androidx.constraintlayout.widget.ConstraintLayout>

La mise en page de la deuxième scène contient les deux mêmes champs de texte, avec les mêmes ID, et placés dans un ordre différent. Il est défini comme suit:

res/layout/another_scene.xml

<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/scene_container"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >
    
    
</androidx.constraintlayout.widget.ConstraintLayout>

Générer des scènes à partir de mises en page

Après avoir créé des définitions pour les deux mises en page de contraintes, vous pouvez obtenir une scène pour chacune d'elles. Cela vous permet de passer d'une configuration à l'autre. Pour obtenir une scène, vous avez besoin d'une référence à la racine de la scène et à l'ID de ressource de mise en page.

L'extrait de code suivant montre comment obtenir une référence à la racine de la scène et créer deux objets Scene à partir des fichiers de mise en page:

Kotlin

val sceneRoot: ViewGroup = findViewById(R.id.scene_root)
val aScene: Scene = Scene.getSceneForLayout(sceneRoot, R.layout.a_scene, this)
val anotherScene: Scene = Scene.getSceneForLayout(sceneRoot, R.layout.another_scene, this)

Java

Scene aScene;
Scene anotherScene;

// Create the scene root for the scenes in this app.
sceneRoot = (ViewGroup) findViewById(R.id.scene_root);

// Create the scenes.
aScene = Scene.getSceneForLayout(sceneRoot, R.layout.a_scene, this);
anotherScene =
    Scene.getSceneForLayout(sceneRoot, R.layout.another_scene, this);

Dans l'application, il existe désormais deux objets Scene basés sur la hiérarchie des vues. Les deux scènes utilisent la racine de la scène définie par l'élément FrameLayout dans res/layout/activity_main.xml.

Créer une scène dans votre code

Vous pouvez également créer une instance Scene dans votre code à partir d'un objet ViewGroup. Utilisez cette technique lorsque vous modifiez les hiérarchies de vues directement dans votre code ou lorsque vous les générez dynamiquement.

Pour créer une scène à partir d'une hiérarchie des vues de votre code, utilisez le constructeur Scene(sceneRoot, viewHierarchy). L'appel de ce constructeur équivaut à appeler la fonction Scene.getSceneForLayout() lorsque vous avez déjà gonflé un fichier de mise en page.

L'extrait de code suivant montre comment créer une instance Scene à partir de l'élément racine et de la hiérarchie des vues de la scène dans votre code:

Kotlin

val sceneRoot = someLayoutElement as ViewGroup
val viewHierarchy = someOtherLayoutElement as ViewGroup
val scene: Scene = Scene(sceneRoot, viewHierarchy)

Java

Scene mScene;

// Obtain the scene root element.
sceneRoot = (ViewGroup) someLayoutElement;

// Obtain the view hierarchy to add as a child of
// the scene root when this scene is entered.
viewHierarchy = (ViewGroup) someOtherLayoutElement;

// Create a scene.
mScene = new Scene(sceneRoot, mViewHierarchy);

Créer des actions de scène

Le framework vous permet de définir des actions de scène personnalisées que le système exécute lors de l'entrée ou de la sortie d'une scène. Dans de nombreux cas, il n'est pas nécessaire de définir des actions de scène personnalisées, car le framework anime automatiquement le changement entre les scènes.

Les actions sur les scènes sont utiles pour gérer les cas suivants:

  • Pour animer des vues qui n'appartiennent pas à la même hiérarchie. Vous pouvez animer des vues pour les scènes de début et de fin à l'aide d'actions de sortie et d'entrée.
  • Pour animer les vues que le framework de transitions ne peut pas animer automatiquement, telles que les objets ListView. Pour en savoir plus, consultez la section sur les limites.

Pour fournir des actions de scène personnalisées, définissez-les en tant qu'objets Runnable, puis transmettez-les aux fonctions Scene.setExitAction() ou Scene.setEnterAction(). Le framework appelle la fonction setExitAction() sur la scène de départ avant d'exécuter l'animation de transition, et la fonction setEnterAction() sur la scène de fin après l'exécution de l'animation de transition.

Appliquer une transition

Le framework de transition représente le style d'animation entre les scènes avec un objet Transition. Vous pouvez instancier un Transition à l'aide de sous-classes intégrées, telles que AutoTransition et Fade, ou définir votre propre transition. Vous pouvez ensuite exécuter l'animation entre les scènes en transmettant votre Scene de fin et le Transition à TransitionManager.go().

Le cycle de vie de la transition est semblable au cycle de vie d'une activité. Il représente les états de transition que le framework surveille entre le début et la fin d'une animation. À des états importants du cycle de vie, le framework appelle des fonctions de rappel que vous pouvez implémenter pour ajuster votre interface utilisateur à différentes phases de la transition.

Créer une transition

La section précédente explique comment créer des scènes représentant l'état de différentes hiérarchies de vues. Après avoir défini les scènes de début et de fin entre lesquelles vous souhaitez passer d'une scène à une autre, créez un objet Transition qui définit une animation. Le framework vous permet soit de spécifier une transition intégrée dans un fichier de ressources et de la gonfler dans votre code, soit de créer une instance de transition intégrée directement dans le code.

Tableau 1. Types de transition intégrés.

Classe Taguer Effet
AutoTransition <autoTransition/> Transition par défaut. Elle disparaît, se déplace et se redimensionne, et disparaît en fondu dans les vues, dans cet ordre.
ChangeBounds <changeBounds/> Déplace et redimensionne les vues.
ChangeClipBounds <changeClipBounds/> Capture la View.getClipBounds() avant et après le changement de scène, et anime ces changements pendant la transition.
ChangeImageTransform <changeImageTransform/> Capture la matrice d'une ImageView avant et après le changement de scène et l'anime pendant la transition.
ChangeScroll <changeScroll/> Capture les propriétés de défilement des cibles avant et après le changement de scène, et anime les éventuels changements.
ChangeTransform <changeTransform/> Capture l'échelle et la rotation des vues avant et après le changement de scène, et les anime pendant la transition.
Explode <explode/> Suit les modifications apportées à la visibilité des vues cibles dans les scènes de début et de fin, et déplace les vues à partir des bords de la scène.
Fade <fade/> fade_in disparaît en fondu dans les vues.
fade_out efface les vues en fondu.
fade_in_out (par défaut) effectue une fade_out suivie d'une fade_in.
Slide <slide/> Suit les modifications apportées à la visibilité des vues cibles dans les scènes de début et de fin, et déplace les vues vers ou depuis l'un des bords de la scène.

Créer une instance de transition à partir d'un fichier de ressources

Cette technique vous permet de modifier la définition de la transition sans changer le code de votre activité. Cette technique est également utile pour séparer les définitions de transitions complexes du code de votre application, comme indiqué dans la section Spécifier plusieurs transitions.

Pour spécifier une transition intégrée dans un fichier de ressources, procédez comme suit:

  • Ajoutez le répertoire res/transition/ à votre projet.
  • Créez un fichier de ressources XML dans ce répertoire.
  • Ajoutez un nœud XML pour l'une des transitions intégrées.

Par exemple, le fichier de ressources suivant spécifie la transition Fade:

res/transition/fade_transition.xml

<fade xmlns:android="http://schemas.android.com/apk/res/android" />

L'extrait de code suivant montre comment gonfler une instance Transition dans votre activité à partir d'un fichier de ressources:

Kotlin

var fadeTransition: Transition =
    TransitionInflater.from(this)
                      .inflateTransition(R.transition.fade_transition)

Java

Transition fadeTransition =
        TransitionInflater.from(this).
        inflateTransition(R.transition.fade_transition);

Créer une instance de transition dans votre code

Cette technique est utile pour créer des objets de transition de manière dynamique si vous modifiez l'interface utilisateur dans votre code et pour créer des instances de transition intégrées simples avec peu ou pas de paramètres.

Pour créer une instance de transition intégrée, appelez l'un des constructeurs publics dans les sous-classes de la classe Transition. Par exemple, l'extrait de code suivant crée une instance de la transition Fade:

Kotlin

var fadeTransition: Transition = Fade()

Java

Transition fadeTransition = new Fade();

Appliquer une transition

Une transition s'applique généralement pour passer d'une hiérarchie de vue à une autre en réponse à un événement, tel qu'une action de l'utilisateur. Prenons l'exemple d'une application de recherche : lorsque l'utilisateur saisit un terme de recherche et appuie sur le bouton de recherche, l'application passe à une scène représentant la mise en page des résultats, tout en appliquant une transition qui fait disparaître le bouton de recherche et s'estompe dans les résultats de recherche.

Pour effectuer un changement de scène tout en appliquant une transition en réponse à un événement de votre activité, appelez la fonction de classe TransitionManager.go() avec la scène de fin et l'instance de transition à utiliser pour l'animation, comme indiqué dans l'extrait suivant:

Kotlin

TransitionManager.go(endingScene, fadeTransition)

Java

TransitionManager.go(endingScene, fadeTransition);

Le framework modifie la hiérarchie des vues à la racine de la scène par celle de la scène finale lors de l'exécution de l'animation spécifiée par l'instance de transition. La scène de départ est la scène d'arrivée de la dernière transition. En l'absence de transition précédente, la scène de départ est déterminée automatiquement à partir de l'état actuel de l'interface utilisateur.

Si vous ne spécifiez pas d'instance de transition, le gestionnaire de transition peut appliquer une transition automatique qui effectue une opération raisonnable dans la plupart des cas. Pour en savoir plus, consultez la documentation de référence de l'API sur la classe TransitionManager.

Choisir des vues cibles spécifiques

Par défaut, le framework applique des transitions à toutes les vues des scènes de début et de fin. Dans certains cas, vous ne souhaiterez peut-être appliquer une animation qu'à un sous-ensemble de vues d'une scène. Le framework vous permet de sélectionner les vues spécifiques que vous souhaitez animer. Par exemple, le framework n'accepte pas l'animation des modifications apportées aux objets ListView. Par conséquent, n'essayez pas de les animer pendant une transition.

Chaque vue animée par la transition est appelée cible. Vous ne pouvez sélectionner que des cibles qui font partie de la hiérarchie des vues associée à une scène.

Pour supprimer une ou plusieurs vues de la liste des cibles, appelez la méthode removeTarget() avant de lancer la transition. Pour n'ajouter que les vues que vous spécifiez à la liste des cibles, appelez la fonction addTarget(). Pour en savoir plus, consultez la documentation de référence de l'API sur la classe Transition.

Spécifier plusieurs transitions

Pour tirer le meilleur parti d'une animation, faites-la correspondre au type de modifications qui se produisent entre les scènes. Par exemple, si vous supprimez certaines vues et que vous en ajoutez d'autres entre les scènes, un fondu à l'ouverture ou à un fondu d'animation indique clairement que certaines vues ne sont plus disponibles. Si vous déplacez des vues vers différents points de l'écran, il est préférable d'animer le mouvement pour que les utilisateurs remarquent le nouvel emplacement des vues.

Vous n'avez pas besoin de choisir une seule animation, car le framework de transitions vous permet de combiner des effets d'animation dans un ensemble de transitions contenant un groupe de transitions individuelles ou intégrées.

Pour définir un ensemble de transitions à partir d'une collection de transitions au format XML, créez un fichier de ressources dans le répertoire res/transitions/ et répertoriez les transitions sous l'élément TransitionSet. Par exemple, l'extrait de code suivant montre comment spécifier un ensemble de transition ayant le même comportement que la classe AutoTransition:

<transitionSet xmlns:android="http://schemas.android.com/apk/res/android"
    android:transitionOrdering="sequential">
    <fade android:fadingMode="fade_out" />
    <changeBounds />
    <fade android:fadingMode="fade_in" />
</transitionSet>

Pour gonfler l'ensemble de transition dans un objet TransitionSet dans votre code, appelez la fonction TransitionInflater.from() dans votre activité. La classe TransitionSet s'étend à partir de la classe Transition. Vous pouvez donc l'utiliser avec un gestionnaire de transition comme n'importe quelle autre instance Transition.

Appliquer une transition sans scènes

La modification de la hiérarchie des vues n'est pas le seul moyen de modifier votre interface utilisateur. Vous pouvez également apporter des modifications en ajoutant, modifiant et supprimant des vues enfants dans la hiérarchie actuelle.

Par exemple, vous pouvez implémenter une interaction de recherche avec une seule mise en page. Commencez par la mise en page affichant un champ de recherche et une icône de recherche. Pour modifier l'interface utilisateur afin d'afficher les résultats, supprimez le bouton de recherche lorsque l'utilisateur appuie dessus en appelant la fonction ViewGroup.removeView() et ajoutez les résultats de recherche en appelant la fonction ViewGroup.addView().

Vous pouvez utiliser cette approche si l'alternative consiste à avoir deux hiérarchies presque identiques. Plutôt que de créer et de gérer deux fichiers de mise en page distincts pour une différence mineure dans l'interface utilisateur, vous pouvez disposer d'un fichier de mise en page contenant une hiérarchie des vues que vous modifiez dans le code.

Si vous apportez des modifications dans la hiérarchie des vues actuelle de cette manière, vous n'avez pas besoin de créer de scène. À la place, vous pouvez créer et appliquer une transition entre deux états d'une hiérarchie des vues à l'aide d'une transition différée. Cette fonctionnalité du framework de transition commence par l'état actuel de la hiérarchie des vues, enregistre les modifications que vous apportez à ses vues et applique une transition qui anime ces modifications lorsque le système redessine l'interface utilisateur.

Pour créer une transition différée dans une hiérarchie de vues unique, procédez comme suit:

  1. Lorsque l'événement qui déclenche la transition se produit, appelez la fonction TransitionManager.beginDelayedTransition(), qui fournit la vue parent de toutes les vues que vous souhaitez modifier et la transition à utiliser. Le framework stocke l'état actuel des vues enfants et les valeurs de leurs propriétés.
  2. Modifiez les vues enfants selon les besoins de votre cas d'utilisation. Le framework enregistre les modifications que vous apportez aux vues enfants et à leurs propriétés.
  3. Lorsque le système redessine l'interface utilisateur en fonction de vos modifications, le framework anime les changements entre l'état d'origine et le nouvel état.

L'exemple suivant montre comment animer l'ajout d'une vue de texte à une hiérarchie des vues à l'aide d'une transition différée. Le premier extrait montre le fichier de définition de mise en page:

res/layout/activity_main.xml

<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/mainLayout"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >
    <EditText
        android:id="@+id/inputText"
        android:layout_alignParentLeft="true"
        android:layout_alignParentTop="true"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent" />
    ...
</androidx.constraintlayout.widget.ConstraintLayout>

L'extrait suivant montre le code qui anime l'ajout de l'affichage de texte:

MainActivity

Kotlin

setContentView(R.layout.activity_main)
val labelText = TextView(this).apply {
    text = "Label"
    id = R.id.text
}
val rootView: ViewGroup = findViewById(R.id.mainLayout)
val mFade: Fade = Fade(Fade.IN)
TransitionManager.beginDelayedTransition(rootView, mFade)
rootView.addView(labelText)

Java

private TextView labelText;
private Fade mFade;
private ViewGroup rootView;
...
// Load the layout.
setContentView(R.layout.activity_main);
...
// Create a new TextView and set some View properties.
labelText = new TextView(this);
labelText.setText("Label");
labelText.setId(R.id.text);

// Get the root view and create a transition.
rootView = (ViewGroup) findViewById(R.id.mainLayout);
mFade = new Fade(Fade.IN);

// Start recording changes to the view hierarchy.
TransitionManager.beginDelayedTransition(rootView, mFade);

// Add the new TextView to the view hierarchy.
rootView.addView(labelText);

// When the system redraws the screen to show this update,
// the framework animates the addition as a fade in.

Définir des rappels de cycle de vie d'une transition

Le cycle de vie de la transition est semblable au cycle de vie d'une activité. Elle représente les états de transition que le framework surveille pendant la période entre un appel à la fonction TransitionManager.go() et la fin de l'animation. À des états importants du cycle de vie, le framework appelle des rappels définis par l'interface TransitionListener.

Les rappels de cycle de vie de transition sont utiles, par exemple, pour copier une valeur de propriété de vue de la hiérarchie des vues de départ vers la hiérarchie des vues de fin lors d'un changement de scène. Vous ne pouvez pas simplement copier la valeur de sa vue de départ vers la vue de la hiérarchie des vues de fin, car la hiérarchie des vues de fin n'est pas gonflée tant que la transition n'est pas terminée. À la place, vous devez stocker la valeur dans une variable, puis la copier dans la hiérarchie des vues de fin lorsque le framework a terminé la transition. Pour être averti lorsque la transition est terminée, implémentez la fonction TransitionListener.onTransitionEnd() dans votre activité.

Pour en savoir plus, consultez la documentation de référence de l'API sur la classe TransitionListener.

Limites

Cette section présente certaines limites connues du cadre de transition:

  • Les animations appliquées à un élément SurfaceView peuvent ne pas s'afficher correctement. Les instances SurfaceView sont mises à jour à partir d'un thread autre qu'un thread UI. Il est donc possible que les mises à jour ne soient pas synchronisées avec les animations d'autres vues.
  • Certains types de transition spécifiques peuvent ne pas produire l'effet d'animation souhaité lorsqu'ils sont appliqués à un TextureView.
  • Les classes qui étendent AdapterView, telles que ListView, gèrent leurs vues enfants d'une manière incompatible avec le framework des transitions. Si vous essayez d'animer une vue basée sur AdapterView, l'écran de l'appareil peut cesser de répondre.
  • Si vous essayez de redimensionner une TextView avec une animation, le texte apparaît à un nouvel emplacement avant que l'objet ne soit complètement redimensionné. Pour éviter ce problème, n'animez pas le redimensionnement des vues contenant du texte.