اقدامات کلی

می‌توانید از کنش سراسری برای ایجاد کنش مشترکی استفاده کنید که چند مقصد بتوانند از آن استفاده کنند. برای مثال، ممکن است بخواهید دکمه‌ها در مقصدهای مختلف به همان صفحه اصلی برنامه پیمایش کنند.

یک کنش سراسری در «ویرایشگر پیمایش» با پیکان کوچکی نشان داده می‌شود که به مقصد مربوطه اشاره می‌کند، همان‌طور که در شکل ۱ نشان داده شده است.

شکل ۱. کنش عمومی که به نمودار تودرتو منجر می‌شود.

ایجاد کنش عمومی

برای ایجاد کنش عمومی، کارهای زیر را انجام دهید:

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

کاتلین

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

جاوا

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

استفاده از «آرگومان‌های ایمن» با کنش سراسری

برای کسب اطلاعات درباره استفاده از «آرگومان‌های ایمن» با کنش‌های سراسری، به انتقال داده بین مقصدها مراجعه کنید.

منابع بیشتر

برای کسب اطلاعات بیشتر درباره پیمایش، به منابع تکمیلی زیر مراجعه کنید.

Codelabs

ویدیوها