Animuj przejścia między miejscami docelowymi

Komponent nawigacji umożliwia dodawanie do działań animacji właściwości i widoku. Aby utworzyć własne animacje, zapoznaj się z zasobami dotyczącymi animacji.

Nawigacja zawiera też kilka domyślnych animacji, które pomogą Ci zacząć. Aby dodać animacje do działania:

  1. W edytorze nawigacji kliknij działanie, w którym ma wystąpić animacja.
  2. W sekcji Animacje w panelu Atrybuty kliknij strzałkę w dół obok animacji, którą chcesz dodać. Możesz wybrać jeden z tych typów:
    • Wpisywanie miejsca docelowego
    • Opuszczanie miejsca docelowego
    • wpisanie miejsca docelowego za pomocą działania pop, które podczas nawigacji usuwa dodatkowe miejsca docelowe ze stosu wstecznego;
    • Opuszczanie miejsca docelowego za pomocą działania wyskakującego
  3. Wybierz animację z wyświetlonej listy animacji projektu.
sekcja animacji w panelu atrybutów
Rysunek 1. Sekcja Animacje w panelu Atrybuty.

Po dodaniu animacji kliknij kartę Tekst, aby przełączyć się na widok tekstu XML. Kod XML animacji pojawi się teraz w odpowiednim elemencie <action>. W poniższym przykładzie specifyAmountFragment jest miejscem docelowym źródła działania 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>

Dodawanie przejść między miejscami docelowymi z udostępnionymi elementami

Gdy widok jest udostępniany między 2 miejscami docelowymi, możesz użyć przejścia elementu wspólnego, aby określić, jak widok ma się zmieniać podczas przechodzenia z jednego miejsca docelowego do drugiego. Przejścia elementów udostępnionych są częścią platformy Transition Framework.

Udostępnione elementy są dostarczane automatycznie, a nie za pomocą pliku XML nawigacji. Miejsca docelowe aktywności i fragmentu mają podklasę interfejsu Navigator.Extras, która akceptuje dodatkowe opcje nawigacji, w tym udostępnione elementy. Możesz przekazać te Extras podczas wywoływania navigate().

Przejścia elementów udostępnionych do miejsca docelowego fragmentu

Klasa FragmentNavigator.Extras umożliwia mapowanie elementów udostępnionych z jednego miejsca docelowego do drugiego według nazwy przejścia, podobnie jak w przypadku FragmentTransaction.addSharedElement(). Następnie możesz przekazać dodatkowe informacje do navigate(), jak pokazano w tym przykładzie:

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

Przejścia elementów wspólnych do miejsca docelowego aktywności

Aktywności korzystają z ActivityOptionsCompat do kontrolowania przejść elementów udostępnionych, jak opisano w dokumentacji Rozpoczynanie aktywności z elementem udostępnionym i jak pokazano w tym przykładzie:

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

Stosowanie animacji wyskakujących do przejść między aktywnościami

Gdy przechodzisz do lub z Activity, animacje wyskakujące nie są stosowane automatycznie. Zamiast tego musisz wywołać funkcję ActivityNavigator.applyPopAnimationsToPendingTransition() z miejsca docelowego Activity, w którym ma zostać wyświetlona animacja:

Kotlin

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

Java

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