إضافة إجراء سهم متّجه للأعلى

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

توضّح لك هذه الصفحة كيفية إضافة زرّ للأعلى إلى شريط تطبيقات باستخدام مكوِّن التنقّل في Jetpack. للحصول على شرح أكثر تفصيلاً، يمكنك الاطّلاع على تحديث مكونات واجهة المستخدم باستخدام NavigationUI.

إعداد شريط التطبيقات

اضبط شريط التطبيقات باستخدام AppBarConfiguration. من AppBarConfiguration، يمكنك إعلام شريط التطبيقات بالوجهات ذات المستوى الأعلى. إذا تم ضبط لائحة التنقّل، سيظهر رمز قائمة اللائحة على شريط التطبيقات في الوجهات ذات المستوى الأعلى. إذا لم يتم ضبط لائحة التنقّل، سيكون زر التنقّل مخفيًا في الوجهات ذات المستوى الأعلى.

وفي كلتا الحالتين، يظهر الزر للأعلى في جميع الوجهات الأخرى. يؤدي الضغط على الزر للأعلى إلى استدعاء navigateUp().

يعرض المثال التالي كيفية ضبط شريط التطبيقات باستخدام AppBarConfiguration:

Kotlin

  override fun onCreate(savedInstanceState: Bundle?) {
    ...
    val navController = findNavController(R.id.nav_host_fragment_activity_main)
    
    val appBarConfiguration = AppBarConfiguration(
        setOf(
            R.id.navigation_home, R.id.navigation_dashboard, R.id.navigation_notifications
        )
    )
    binding.myToolbar.setupWithNavController(navController, appBarConfiguration)
  }
  

Java

  @Override
  protected void onCreate(Bundle savedInstanceState) {
      ...
      NavController navController = Navigation.findNavController(this, R.id.nav_host_fragment_activity_main);

      AppBarConfiguration appBarConfiguration = new AppBarConfiguration.Builder(
              R.id.navigation_home, R.id.navigation_dashboard, R.id.navigation_notifications)
              .build();
      NavigationUI.setupWithNavController(binding.myToolbar, navController, appBarConfiguration);
  }