الإجراءات العامة

يمكنك استخدام إجراء عام لإنشاء إجراء مشترك عدة التي يمكن للوجهات استخدامها. على سبيل المثال، قد تريد الأزرار في ووجهات مختلفة للانتقال إلى نفس شاشة التطبيق الرئيسية.

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

الشكل 1. يشير هذا المصطلح إلى إجراء عام يؤدي إلى إجراء الرسم البياني.

إنشاء إجراء عام

لإنشاء إجراء عام، يُرجى تنفيذ ما يلي:

  1. من محرِّر الرسم البياني، انقر على وجهة لإبرازها.
  2. انقر بزر الماوس الأيمن على الوجهة لعرض قائمة السياقات.
  3. حدد إضافة إجراء > جميع أنحاء العالم. سهم () يظهر إلى يسار الوجهة.

  4. انقر على علامة التبويب النص للانتقال إلى عرض نص XML. يمثل XML الخاص بـ الإجراء العام يشبه ما يلي:

    <?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:app="http://schemas.android.com/apk/res-auto"
            xmlns:tools="http://schemas.android.com/tools"
            xmlns:android="http://schemas.android.com/apk/res/android"
            android:id="@+id/main_nav"
            app:startDestination="@id/mainFragment">

  ...

  <action android:id="@+id/action_global_mainFragment"
          app:destination="@id/mainFragment"/>

</navigation>

استخدام إجراء عام

لاستخدام إجراء عام في الرمز الخاص بك، عليك تمرير رقم تعريف المصدر للإجراء العام. إلى navigate() لكل عنصر من عناصر واجهة المستخدم، كما هو موضح في المثال التالي:

Kotlin

viewTransactionButton.setOnClickListener { view ->
    view.findNavController().navigate(R.id.action_global_mainFragment)
}

Java

viewTransactionsButton.setOnClickListener(new View.OnClickListener() {
   @Override
   public void onClick(View view) {
       Navigation.findNavController(view).navigate(R.id.action_global_mainFragment);
   }
});

استخدام الوسيطات الآمنة مع إجراء عام

للحصول على معلومات عن استخدام الوسيطات الآمنة مع الإجراءات العامة، يمكنك الاطّلاع على تمرير البيانات بين الوجهات:

مصادر إضافية

للاطّلاع على مزيد من المعلومات حول التنقّل، يُرجى الرجوع إلى ما يلي: والموارد الإضافية.

نماذج

الدروس التطبيقية حول الترميز

الفيديوهات