Übergänge zwischen Zielen animieren

Mit der Navigationskomponente können Sie Aktionen sowohl Attribut- als auch Ansichtsanimationen hinzufügen. Wenn Sie eigene Animationen erstellen möchten, finden Sie unter Animationsressourcen weitere Informationen.

Die Navigation enthält auch mehrere Standardanimationen, die Ihnen den Einstieg erleichtern. So fügen Sie einer Aktion Animationen hinzu:

  1. Klicken Sie im Navigationseditor auf die Aktion, bei der die Animation erfolgen soll.
  2. Klicken Sie im Bereich Animationen des Steuerfelds Attribute auf den Drop-down-Pfeil neben der Animation, die Sie hinzufügen möchten. Sie können zwischen den folgenden Typen wählen:
    • Ziel eingeben
    • Ziel verlassen
    • Eingabe eines Ziels mit einer Pop-Aktion, einer Aktion, die beim Navigieren zusätzliche Ziele aus dem Back Stack entfernt.
    • Ziel mit einer Pop-Aktion verlassen
  3. Wählen Sie eine Animation aus der Liste der Projektanimationen aus.
den Bereich „Animationen“ im Attributbereich
Abbildung 1. Der Bereich Animationen im Bereich Attribute.

Nachdem Sie Animationen hinzugefügt haben, klicken Sie auf den Tab Text, um zur XML-Textansicht zu wechseln. Die XML für die Animationen wird jetzt im entsprechenden <action>-Element angezeigt. Im folgenden Beispiel ist specifyAmountFragment das Quellziel für die Aktion 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>

Übergänge mit gemeinsam genutzten Elementen zwischen Zielen hinzufügen

Wenn eine Ansicht von zwei Zielen gemeinsam genutzt wird, können Sie mit einem Übergang für freigegebene Elemente festlegen, wie die Ansicht beim Wechsel von einem Ziel zum anderen übergeht. Übergänge für freigegebene Elemente sind Teil des Transition Frameworks.

Gemeinsame Elemente werden programmatisch und nicht über die XML-Navigationsdatei bereitgestellt. Aktivitäts- und Fragmentziele haben jeweils eine Unterklasse der Navigator.Extras-Schnittstelle, die zusätzliche Optionen für die Navigation akzeptiert, einschließlich freigegebener Elemente. Sie können diese Extras beim Aufrufen von navigate() übergeben.

Übergänge mit gemeinsam genutzten Elementen zu einem Fragmentziel

Mit der Klasse FragmentNavigator.Extras können Sie freigegebene Elemente von einem Ziel zum nächsten anhand ihres Übergangsnamens zuordnen, ähnlich wie bei FragmentTransaction.addSharedElement(). Anschließend können Sie die Extras an navigate() übergeben, wie im folgenden Beispiel gezeigt:

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);

Übergänge mit gemeinsam genutzten Elementen zu einem Aktivitätsziel

Aktivitäten nutzen ActivityOptionsCompat, um Übergänge für freigegebene Elemente zu steuern, wie in der Dokumentation Aktivität mit einem freigegebenen Element starten beschrieben und im folgenden Beispiel gezeigt:

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);

Pop-Animationen auf Aktivitätsübergänge anwenden

Wenn Sie zu oder von einem Activity navigieren, werden Pop-Animationen nicht automatisch angewendet. Stattdessen müssen Sie ActivityNavigator.applyPopAnimationsToPendingTransition() vom Ziel-Activity aufrufen, in dem die Animation erfolgen soll:

Kotlin

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

Java

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