تحريك الانتقالات بين الوجهات

يتيح لك مكوّن التنقّل إضافة كل من صور متحركة للسمات والعروض إلى الإجراءات. لإنشاء صور متحركة خاصة بك، يمكنك الاطّلاع على مراجع الصور المتحركة.

يتضمّن التنقّل أيضًا العديد من الصور المتحركة التلقائية لمساعدتك في البدء. لإضافة تأثيرات حركية إلى إجراء، اتّبِع الخطوات التالية:

  1. في محرِّر التنقّل، انقر على الإجراء الذي يجب أن تظهر فيه الحركة.
  2. في قسم الصور المتحركة في لوحة السمات، انقر على سهم القائمة المنسدلة بجانب الصورة المتحركة التي تريد إضافتها. يمكنك الاختيار من بين الأنواع التالية:
    • إدخال وجهة
    • الخروج من وجهة
    • إدخال وجهة باستخدام إجراء إزالة، وهو إجراء يزيل وجهات إضافية من الأنشطة السابقة عند التنقّل.
    • الخروج من وجهة باستخدام إجراء منبثق
  3. اختَر صورة متحركة من قائمة الصور المتحركة للمشروع التي تظهر.
قسم "الصور المتحركة" في لوحة السمات
الشكل 1: قسم الصور المتحركة في لوحة السمات

بعد إضافة الصور المتحركة، انقر على علامة التبويب نص للتبديل إلى عرض نص 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()، كما هو موضّح في المثال التالي:

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