הצגת מעברים בין יעדים

רכיב הניווט מאפשר להוסיף לפעולות גם אנימציות של מאפיינים וגם אנימציות של תצוגות. כדי ליצור אנימציות משלכם, עיינו במקורות מידע בנושא אנימציה.

הניווט כולל גם כמה אנימציות שמוגדרות כברירת מחדל כדי לעזור לכם להתחיל. כדי להוסיף אנימציות לפעולה:

  1. ב-Navigation editor, לוחצים על הפעולה שבה האנימציה אמורה להתרחש.
  2. בקטע אנימציות בחלונית מאפיינים, לוחצים על החץ לתפריט נפתח לצד האנימציה שרוצים להוסיף. אפשר לבחור בין הסוגים הבאים:
    • הזנת יעד
    • יציאה מיעד
    • הזנת יעד באמצעות פעולת pop, פעולה שמוציאה יעדים נוספים ממקבץ הפעילויות הקודמות (back stack) במהלך הניווט.
    • יציאה מיעד באמצעות פעולת pop
  3. בוחרים אנימציה מהרשימה של האנימציות בפרויקט שמופיעה.
הקטע "אנימציות" בחלונית המאפיינים
תרשים 1. הקטע אנימציות בחלונית מאפיינים.

אחרי שמוסיפים אנימציות, לוחצים על הכרטיסייה Text כדי לעבור לתצוגת טקסט XML. עכשיו ה-XML של האנימציות מופיע ברכיב <action> המתאים. בדוגמה הבאה, specifyAmountFragment הוא יעד המקור של הפעולה 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>

הוספת מעברים של רכיבים משותפים בין יעדים

כשתצוגה משותפת בין שני יעדים, אתם יכולים להשתמש במעבר של רכיב משותף כדי להגדיר את המעבר של התצוגה כשמנווטים מיעד אחד לאחר. מעברים של רכיבים משותפים הם חלק מ-Transition Framework.

רכיבים משותפים מסופקים באופן פרוגרמטי ולא דרך קובץ ה-XML של הניווט. לכל יעד של פעילות וקטע יש מחלקת משנה של הממשק Navigator.Extras שמקבלת אפשרויות נוספות לניווט, כולל רכיבים משותפים. אפשר להעביר את Extras האלה כשמפעילים את navigate().

מעברים של רכיבים משותפים ליעד של מקטע

הכיתה FragmentNavigator.Extras מאפשרת למפות רכיבים משותפים מיעד אחד ליעד הבא לפי שם המעבר, בדומה לשימוש ב-FragmentTransaction.addSharedElement(). לאחר מכן אפשר להעביר את התוספות אל navigate(), כמו בדוגמה הבאה:

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

מעברים של רכיבים משותפים ליעד של פעילות

פעילויות מסתמכות על ActivityOptionsCompat כדי לשלוט במעברים של רכיבים משותפים, כפי שמפורט במסמכי התיעוד של התחלת פעילות עם רכיב משותף וכפי שמוצג בדוגמה הבאה:

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

החלת אנימציות קופצות על מעברים בין פעילויות

כשמנווטים אל Activity או ממנו, אנימציות קופצות לא מופעלות באופן אוטומטי. במקום זאת, צריך להפעיל את ActivityNavigator.applyPopAnimationsToPendingTransition() מהיעד Activity שבו האנימציה אמורה להתרחש:

Kotlin

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

Java

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