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

تجربة طريقة Compose

‫Jetpack Compose هي مجموعة أدوات واجهة المستخدِم المقترَحة لنظام Android. تعرَّف على كيفية إضافة مكوّنات في Compose.

الانتقال من شريط التطبيق العلوي ←

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

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

ملاحظة: ننصحك باستخدام مكوّن Jetpack Navigation للتعامل مع عملية التنقّل في تطبيقك. يتعامل هذا المكوّن مع عملية التنقّل للأعلى من الشاشة الحالية في تطبيقك عندما ينقر المستخدم على زر "رجوع" . لمزيد من المعلومات، يُرجى الاطّلاع على مستندات مكوّن Jetpack Navigation.

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

يمكنك إعداد شريط التطبيق باستخدام 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);
  }