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:
- Nell'editor di navigazione, fai clic sull'azione in cui deve essere eseguita l'animazione.
- 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
- Scegli un'animazione dall'elenco delle animazioni del progetto visualizzato.
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);
}