Animare le transizioni tra le destinazioni

Il componente Navigazione ti consente di aggiungere animazioni di proprietà e di visualizzazione alle azioni. Per creare le tue animazioni, consulta le risorse per le animazioni.

La navigazione include anche diverse animazioni predefinite per aiutarti a iniziare. Per aggiungere animazioni a un'azione:

  1. Nell'editor di navigazione, fai clic sull'azione in cui deve essere eseguita l'animazione.
  2. Nella sezione Animazioni del riquadro Attributi, fai clic sulla freccia menu a discesa accanto all'animazione che vuoi aggiungere. Puoi scegliere tra i seguenti tipi:
    • Inserimento di una destinazione
    • Uscita da una destinazione
    • Inserimento di una destinazione utilizzando un'azione di uscita, un'azione che rimuove destinazioni aggiuntive dal back stack durante la navigazione.
    • Uscita da una destinazione utilizzando un'azione pop
  3. Scegli un'animazione dall'elenco delle animazioni del progetto visualizzato.
la sezione Animazioni del riquadro degli attributi
Figura 1. La sezione Animazioni del pannello Attributi.

Dopo aver aggiunto le animazioni, fai clic sulla scheda Testo per passare alla visualizzazione del testo XML. Il codice XML per le animazioni ora viene visualizzato nell'elemento <action> corrispondente. Nell'esempio seguente, specifyAmountFragment è la destinazione di origine per l'azione confirmationAction:

<fragment
    android:id="@+id/specifyAmountFragment"
    android:name="com.example.buybuddy.buybuddy.SpecifyAmountFragment"
    android:label="fragment_specify_amount"
    tools:layout="@layout/fragment_specify_amount">
    <action
        android:id="@+id/confirmationAction"
        app:destination="@id/confirmationFragment"
        app:enterAnim="@anim/slide_in_right"
        app:exitAnim="@anim/slide_out_left"
        app:popEnterAnim="@anim/slide_in_left"
        app:popExitAnim="@anim/slide_out_right" />
</fragment>

Aggiungi transizioni di elementi condivisi tra le destinazioni

Quando una visualizzazione è condivisa tra due destinazioni, puoi utilizzare una transizione degli elementi condivisi per definire la transizione della visualizzazione quando passi da una destinazione all'altra. Le transizioni degli elementi condivisi fanno parte del framework di transizione.

Gli elementi condivisi vengono forniti in modo programmatico anziché tramite il file XML di navigazione. Le destinazioni di attività e frammenti hanno ciascuna una sottoclasse dell'interfaccia Navigator.Extras che accetta opzioni aggiuntive per la navigazione, inclusi gli elementi condivisi. Puoi passare questi Extras quando chiami navigate().

Transizioni di elementi condivisi a una destinazione di frammento

La classe FragmentNavigator.Extras ti consente di mappare gli elementi condivisi da una destinazione all'altra in base al nome della transizione, in modo simile all'utilizzo di FragmentTransaction.addSharedElement(). Puoi quindi passare gli extra a navigate(), come mostrato nell'esempio seguente:

Kotlin

val extras = FragmentNavigatorExtras(view1 to "hero_image")

view.findNavController().navigate(
    R.id.confirmationAction,
    null, // Bundle of args
    null, // NavOptions
    extras)

Java

FragmentNavigator.Extras extras = new FragmentNavigator.Extras.Builder()
    .addSharedElement(view1, "hero_image")
    .build();

Navigation.findNavController(view).navigate(
    R.id.details,
    null, // Bundle of args
    null, // NavOptions
    extras);

Transizioni di elementi condivisi a una destinazione di attività

Le attività si basano su ActivityOptionsCompat per controllare le transizioni degli elementi condivisi, come descritto nella documentazione Avvia un'attività con un elemento condiviso e come mostrato nell'esempio seguente:

Kotlin

// Rename the Pair class from the Android framework to avoid a name clash
import android.util.Pair as UtilPair
...
val options = ActivityOptionsCompat.makeSceneTransitionAnimation(activity,
        UtilPair.create(view1, "hero_image"))
val extras = ActivityNavigatorExtras(options)
view.findNavController().navigate(
    R.id.details,
    null, // Bundle of args
    null, // NavOptions
    extras)

Java

ActivityOptions options = ActivityOptions.makeSceneTransitionAnimation(this,
        Pair.create(view1, "hero_image"));

ActivityNavigatorExtras extras = new ActivityNavigatorExtras.Builder()
    .setActivityOptions(options)
    .build();

Navigation.findNavController(view).navigate(
    R.id.details,
    null, // Bundle of args
    null, // NavOptions
    extras);

Applica animazioni pop alle transizioni delle attività

Quando navighi da o verso un Activity, le animazioni di uscita non vengono applicate automaticamente. Devi invece chiamare ActivityNavigator.applyPopAnimationsToPendingTransition() dalla destinazione Activity di destinazione in cui deve avvenire l'animazione:

Kotlin

override fun finish() {
    super.finish()
    ActivityNavigator.applyPopAnimationsToPendingTransition(this)
}

Java

@Override
public void finish() {
    super.finish();
    ActivityNavigator.applyPopAnimationsToPendingTransition(this);
}