پویانمایی کردن گذار بین مقصدها

مؤلفه «پیمایش» به شما امکان می‌دهد هم پویانمایی‌های دارایی و هم پویانمایی‌های نما را به کنش‌ها اضافه کنید. برای ایجاد پویانمایی‌های خودتان، منابع پویانمایی را بررسی کنید.

«ناوبری» همچنین شامل چندین پویانمایی پیش‌فرض برای شروع کار است. برای افزودن پویانمایی به کنش، کارهای زیر را انجام دهید:

  1. در ویرایشگر «پیمایش»، روی کنشی که پویانمایی باید در آن اتفاق بیفتد کلیک کنید.
  2. در بخش پویانمایی‌ها در پانل مشخصه‌ها، روی کلید کرکره‌ای کنار پویانمایی‌ای که می‌خواهید اضافه کنید کلیک کنید. می‌توانید از بین انواع زیر انتخاب کنید:
    • وارد کردن مقصد
    • خروج از مقصد
    • وارد کردن مقصد بااستفاده از کنش پاپ، کنشی که هنگام پیمایش، مقصدهای اضافی را از پشته قبلی‌ها پاپ می‌کند.
    • خروج از مقصد بااستفاده از کنش پاپ‌آپ
  3. پویانمایی‌ای را از فهرست پویانمایی‌های پروژه که نشان داده می‌شود انتخاب کنید.
بخش پویانمایی‌ها در پانل مشخصه‌ها
شکل ۱. بخش پویانمایی‌ها در پانل مشخصه‌ها.

پس‌از افزودن پویانمایی‌ها، روی برگه نوشتار کلیک کنید تا به نمای نوشتار 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>

افزودن گذرهای عنصر هم‌رسانی‌شده بین مقصدها

وقتی نمایی بین دو مقصد هم‌رسانی می‌شود، می‌توانید از گذار عنصر هم‌رسانی‌شده برای تعریف نحوه گذار نما هنگام پیمایش از یک مقصد به مقصد دیگر استفاده کنید. گذار عنصر مشترک بخشی از چارچوب گذار است.

عناصر هم‌رسانی‌شده به‌جای فایل XML پیمایش، به‌صورت برنامه‌نویسی‌شده ارائه می‌شوند. مقصد فعالیت و قطعه هرکدام زیرکلاسی از میانای Navigator.Extras دارند که گزینه‌های اضافی برای پیمایش، ازجمله عناصر مشترک، را می‌پذیرد. می‌توانید این Extras را هنگام تماس با navigate() رد کنید.

انتقال‌های عنصر مشترک به مقصد قطعه

کلاس FragmentNavigator.Extras به شما امکان می‌دهد عناصر مشترک را از یک مقصد به مقصد بعدی با نام انتقال آن‌ها نگاشت کنید، مشابه استفاده از FragmentTransaction.addSharedElement(). سپس می‌توانید موارد اضافی را به navigate() ارسال کنید، همان‌طور که در مثال زیر نشان داده شده است:

کاتلین

val extras = FragmentNavigatorExtras(view1 to "hero_image")

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

جاوا

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 متکی هستند، همان‌طور که در سند شروع فعالیت با عنصر هم‌رسانی‌شده به‌تفصیل شرح داده شده و در مثال زیر نشان داده شده است:

کاتلین

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

جاوا

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 هدف که پویانمایی باید در آنجا رخ دهد فراخوانی کنید:

کاتلین

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

جاوا

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