يتضمّن مكوّن التنقّل فئة NavigationUI. تحتوي هذه الفئة على طرق ثابتة لإدارة التنقّل باستخدام شريط التطبيق العلوي ولائحة التنقّل وشريط التنقّل السفلي.
شريط التطبيق العلوي
يوفّر شريط التطبيق العلوي مكانًا ثابتًا في أعلى التطبيق لعرض المعلومات والإجراءات من الشاشة الحالية.
يحتوي NavigationUI على طرق لتعديل المحتوى تلقائيًا في شريط التطبيق العلوي أثناء تنقّل المستخدمين في تطبيقك. على سبيل المثال، يستخدم NavigationUI تصنيفات الوجهات من الرسم البياني للتنقّل من أجل إبقاء عنوان شريط التطبيق العلوي محدّثًا.
<navigation> <fragment ... android:label="Page title"> ... </fragment> </navigation>
عند استخدام NavigationUI مع عمليات تنفيذ شريط التطبيق العلوي الموضّحة أدناه،
يمكن تعبئة التصنيف الذي ترفقه بالوجهات تلقائيًا من
الوسيطات المقدَّمة إلى الوجهة باستخدام تنسيق {argName} في
التصنيف.
يتيح NavigationUI استخدام الأنواع التالية من أشرطة التطبيقات العلوية:
لمزيد من المعلومات حول أشرطة التطبيقات، يُرجى الاطّلاع على مقالة إعداد شريط التطبيقات.
AppBarConfiguration
يستخدم NavigationUI عنصر AppBarConfiguration لإدارة سلوك زر التنقّل في أعلى يمين منطقة عرض تطبيقك.
يتغيّر سلوك زر "التنقّل" حسب ما إذا كان المستخدم في وجهة ذات مستوى أعلى.
الوجهة ذات المستوى الأعلى هي الوجهة الجذرية أو الوجهة ذات المستوى الأعلى في مجموعة من الوجهات ذات الصلة الهرمية. لا تعرض الوجهات ذات المستوى الأعلى زر "أعلى" في شريط التطبيقات العلوي لعدم وجود وجهة ذات مستوى أعلى. بشكل افتراضي، تكون وجهة البدء لتطبيقك هي الوجهة الوحيدة ذات المستوى الأعلى.
عندما يكون المستخدم في وجهة ذات مستوى أعلى، يصبح زر التنقّل
رمز درج
إذا كانت الوجهة تستخدم DrawerLayout. إذا كانت الوجهة لا تستخدم
DrawerLayout، يتم إخفاء زر "التنقّل". عندما يكون المستخدم في أي وجهة أخرى، يظهر زر التنقل كزر "أعلى"
.
لضبط زر التنقّل باستخدام وجهة البدء فقط كوجهة المستوى الأعلى، أنشئ عنصر AppBarConfiguration وأدخِل الرسم البياني للتنقّل المقابل، كما هو موضّح أدناه:
Kotlin
val appBarConfiguration = AppBarConfiguration(navController.graph)
Java
AppBarConfiguration appBarConfiguration =
new AppBarConfiguration.Builder(navController.getGraph()).build();
في بعض الحالات، قد تحتاج إلى تحديد وجهات متعددة ذات مستوى أعلى بدلاً من استخدام الوجهة التلقائية للبدء. يُعدّ استخدام BottomNavigationView حالة استخدام شائعة لذلك، حيث قد تكون لديك شاشات شقيقة غير مرتبطة ببعضها البعض بشكل هرمي وقد يكون لكل منها مجموعة خاصة بها من الوجهات ذات الصلة. في مثل هذه الحالات، يمكنك بدلاً من ذلك تمرير مجموعة من معرّفات الوجهات إلى الدالة الإنشائية، كما هو موضّح أدناه:
Kotlin
val appBarConfiguration = AppBarConfiguration(setOf(R.id.main, R.id.profile))
Java
AppBarConfiguration appBarConfiguration =
new AppBarConfiguration.Builder(R.id.main, R.id.profile).build();
إنشاء شريط أدوات
لإنشاء شريط أدوات باستخدام NavigationUI، عليك أولاً تحديد الشريط في نشاطك الرئيسي، كما هو موضّح:
<LinearLayout> <androidx.appcompat.widget.Toolbar android:id="@+id/toolbar" /> <androidx.fragment.app.FragmentContainerView android:id="@+id/nav_host_fragment" ... /> ... </LinearLayout>
بعد ذلك، يمكنك استدعاء setupWithNavController() من إجراء onCreate() الخاص بالنشاط الرئيسي، كما هو موضّح في المثال التالي:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) {
setContentView(R.layout.activity_main)
...
val navController = findNavController(R.id.nav_host_fragment)
val appBarConfiguration = AppBarConfiguration(navController.graph)
findViewById<Toolbar>(R.id.toolbar)
.setupWithNavController(navController, appBarConfiguration)
}
Java
@Override
protected void onCreate(Bundle savedInstanceState) {
setContentView(R.layout.activity_main);
...
NavController navController = Navigation.findNavController(this, R.id.nav_host_fragment);
AppBarConfiguration appBarConfiguration =
new AppBarConfiguration.Builder(navController.getGraph()).build();
Toolbar toolbar = findViewById(R.id.toolbar);
NavigationUI.setupWithNavController(
toolbar, navController, appBarConfiguration);
}
لضبط زر التنقّل ليظهر كزر "للأعلى" لجميع الوجهات، يمكنك تمرير مجموعة فارغة من أرقام تعريف الوجهات لوجهاتك ذات المستوى الأعلى عند إنشاء AppBarConfiguration. قد يكون ذلك مفيدًا
إذا كان لديك مثلاً نشاط ثانٍ يجب أن يعرض زر "الانتقال للأعلى"
في Toolbar على جميع الوجهات. يتيح ذلك للمستخدم الانتقال مرة أخرى إلى النشاط الرئيسي عندما لا تكون هناك وجهات أخرى في الأنشطة السابقة. يمكنك استخدام setFallbackOnNavigateUpListener() للتحكّم في
سلوك الاحتياطي عندما لا يؤدي navigateUp() أي إجراء، كما هو موضّح
في المثال التالي:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) {
...
val navHostFragment =
supportFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
val navController = navHostFragment.navController
val appBarConfiguration = AppBarConfiguration(
topLevelDestinationIds = setOf(),
fallbackOnNavigateUpListener = ::onSupportNavigateUp
)
findViewById<Toolbar>(R.id.toolbar)
.setupWithNavController(navController, appBarConfiguration)
}
Java
@Override
protected void onCreate(Bundle savedInstanceState) {
...
NavHostFragment navHostFragment = (NavHostFragment) supportFragmentManager.findFragmentById(R.id.nav_host_fragment);
NavController navController = navHostFragment.getNavController();
AppBarConfiguration appBarConfiguration = new AppBarConfiguration.Builder()
.setFallbackOnNavigateUpListener(::onSupportNavigateUp)
.build();
Toolbar toolbar = findViewById(R.id.toolbar);
NavigationUI.setupWithNavController(
toolbar, navController, appBarConfiguration);
}
تضمين CollapsingToolbarLayout
لتضمين CollapsingToolbarLayout مع شريط الأدوات، حدِّد أولاً
شريط الأدوات والتنسيق المحيط به في نشاطك، كما هو موضّح أدناه:
<LinearLayout> <com.google.android.material.appbar.AppBarLayout android:layout_width="match_parent" android:layout_height="@dimen/tall_toolbar_height"> <com.google.android.material.appbar.CollapsingToolbarLayout android:id="@+id/collapsing_toolbar_layout" android:layout_width="match_parent" android:layout_height="match_parent" app:contentScrim="?attr/colorPrimary" app:expandedTitleGravity="top" app:layout_scrollFlags="scroll|exitUntilCollapsed|snap"> <androidx.appcompat.widget.Toolbar android:id="@+id/toolbar" android:layout_width="match_parent" android:layout_height="?attr/actionBarSize" app:layout_collapseMode="pin"/> </com.google.android.material.appbar.CollapsingToolbarLayout> </com.google.android.material.appbar.AppBarLayout> <androidx.fragment.app.FragmentContainerView android:id="@+id/nav_host_fragment" ... /> ... </LinearLayout>
بعد ذلك، يمكنك استدعاء setupWithNavController() من إجراء onCreate الخاص بالنشاط الرئيسي، كما هو موضّح أدناه:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) {
setContentView(R.layout.activity_main)
...
val layout = findViewById<CollapsingToolbarLayout>(R.id.collapsing_toolbar_layout)
val toolbar = findViewById<Toolbar>(R.id.toolbar)
val navHostFragment =
supportFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
val navController = navHostFragment.navController
val appBarConfiguration = AppBarConfiguration(navController.graph)
layout.setupWithNavController(toolbar, navController, appBarConfiguration)
}
Java
@Override
protected void onCreate(Bundle savedInstanceState) {
setContentView(R.layout.activity_main);
...
CollapsingToolbarLayout layout = findViewById(R.id.collapsing_toolbar_layout);
Toolbar toolbar = findViewById(R.id.toolbar);
NavHostFragment navHostFragment = supportFragmentManager.findFragmentById(R.id.nav_host_fragment);
NavController navController = navHostFragment.getNavController();
AppBarConfiguration appBarConfiguration =
new AppBarConfiguration.Builder(navController.getGraph()).build();
NavigationUI.setupWithNavController(layout, toolbar, navController, appBarConfiguration);
}
شريط الإجراءات
لإضافة ميزة التنقّل إلى شريط التطبيقات التلقائي، يمكنك استدعاء
setupActionBarWithNavController() من إجراء onCreate()
الخاص بالنشاط الرئيسي، كما هو موضّح أدناه. يُرجى العِلم أنّه عليك الإعلان عن AppBarConfiguration
خارج onCreate()، لأنّك تستخدمه أيضًا عند إلغاء
onSupportNavigateUp():
Kotlin
private lateinit var appBarConfiguration: AppBarConfiguration
...
override fun onCreate(savedInstanceState: Bundle?) {
...
val navHostFragment =
supportFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
val navController = navHostFragment.navController
appBarConfiguration = AppBarConfiguration(navController.graph)
setupActionBarWithNavController(navController, appBarConfiguration)
}
Java
AppBarConfiguration appBarConfiguration;
...
@Override
protected void onCreate(Bundle savedInstanceState) {
...
NavHostFragment navHostFragment = supportFragmentManager.findFragmentById(R.id.nav_host_fragment);
NavController navController = navHostFragment.getNavController();
appBarConfiguration = new AppBarConfiguration.Builder(navController.getGraph()).build();
NavigationUI.setupActionBarWithNavController(this, navController, appBarConfiguration);
}
بعد ذلك، يمكنك إلغاء onSupportNavigateUp() للتعامل مع التنقّل للأعلى:
Kotlin
override fun onSupportNavigateUp(): Boolean {
val navController = findNavController(R.id.nav_host_fragment)
return navController.navigateUp(appBarConfiguration)
|| super.onSupportNavigateUp()
}
Java
@Override
public boolean onSupportNavigateUp() {
NavController navController = Navigation.findNavController(this, R.id.nav_host_fragment);
return NavigationUI.navigateUp(navController, appBarConfiguration)
|| super.onSupportNavigateUp();
}
إتاحة نُسخ مختلفة من شريط التطبيقات
تكون إضافة شريط التطبيق العلوي إلى نشاطك مفيدة عندما يكون تنسيق شريط التطبيق متشابهًا لكل وجهة في تطبيقك. ومع ذلك، إذا كان شريط التطبيق العلوي يتغير بشكل كبير عبر الوجهات، ففكر في إزالة شريط التطبيق العلوي من نشاطك وتحديده في كل جزء وجهة بدلاً من ذلك.
على سبيل المثال، قد تستخدم إحدى وجهاتك Toolbar عاديًا، بينما تستخدم وجهة أخرى AppBarLayout لإنشاء شريط تطبيقات أكثر تعقيدًا يتضمّن علامات تبويب، كما هو موضّح في الشكل 2.
Toolbar عادي. على اليسار، يظهر AppBarLayout مع Toolbar وعلامات تبويب.لتنفيذ هذا المثال ضمن أجزاء الوجهة باستخدام
NavigationUI، حدِّد أولاً شريط التطبيق في كل تنسيق من تنسيقات الأجزاء،
بدءًا من جزء الوجهة الذي يستخدم شريط أدوات عاديًا:
<LinearLayout>
<androidx.appcompat.widget.Toolbar
android:id="@+id/toolbar"
... />
...
</LinearLayout>
بعد ذلك، حدِّد الجزء المقصود الذي يستخدم شريط تطبيقات يتضمّن علامات تبويب:
<LinearLayout>
<com.google.android.material.appbar.AppBarLayout
... />
<androidx.appcompat.widget.Toolbar
android:id="@+id/toolbar"
... />
<com.google.android.material.tabs.TabLayout
... />
</com.google.android.material.appbar.AppBarLayout>
...
</LinearLayout>
منطق إعداد التنقّل هو نفسه لكل من هذين المقتطفَين،
باستثناء أنّه عليك استدعاء setupWithNavController() من داخل طريقة onViewCreated() لكل مقتطف، بدلاً من إعدادها من
النشاط:
Kotlin
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
val navController = findNavController()
val appBarConfiguration = AppBarConfiguration(navController.graph)
view.findViewById<Toolbar>(R.id.toolbar)
.setupWithNavController(navController, appBarConfiguration)
}
Java
@Override
public void onViewCreated(@NonNull View view,
@Nullable Bundle savedInstanceState) {
NavController navController = Navigation.findNavController(view);
AppBarConfiguration appBarConfiguration =
new AppBarConfiguration.Builder(navController.getGraph()).build();
Toolbar toolbar = view.findViewById(R.id.toolbar);
NavigationUI.setupWithNavController(
toolbar, navController, appBarConfiguration);
}
ربط الوجهات بعناصر القائمة
توفّر NavigationUI أيضًا أدوات مساعدة لربط الوجهات بمكوّنات واجهة المستخدم المستندة إلى القوائم. يحتوي NavigationUI على طريقة مساعِدة، وهي onNavDestinationSelected()، والتي تأخذ MenuItem مع NavController الذي يستضيف الوجهة المرتبطة. إذا تطابق id MenuItem مع id الوجهة، يمكن لـ NavController الانتقال إلى تلك الوجهة.
على سبيل المثال، تحدّد مقتطفات XML أدناه عنصر قائمة ووجهة باستخدام السمتَين id وdetails_page_fragment الشائعتَين:
<?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" ... > ... <fragment android:id="@+id/details_page_fragment" android:label="@string/details" android:name="com.example.android.myapp.DetailsFragment" /> </navigation>
<menu xmlns:android="http://schemas.android.com/apk/res/android"> ... <item android:id="@+id/details_page_fragment" android:icon="@drawable/ic_details" android:title="@string/details" /> </menu>
إذا تمت إضافة القائمة باستخدام onCreateOptionsMenu() في النشاط، على سبيل المثال، يمكنك ربط عناصر القائمة بالوجهات من خلال إلغاء onOptionsItemSelected() في النشاط لاستدعاء onNavDestinationSelected()، كما هو موضّح في المثال التالي:
Kotlin
override fun onOptionsItemSelected(item: MenuItem): Boolean {
val navController = findNavController(R.id.nav_host_fragment)
return item.onNavDestinationSelected(navController) || super.onOptionsItemSelected(item)
}
Java
@Override
public boolean onOptionsItemSelected(MenuItem item) {
NavController navController = Navigation.findNavController(this, R.id.nav_host_fragment);
return NavigationUI.onNavDestinationSelected(item, navController)
|| super.onOptionsItemSelected(item);
}
الآن، عندما ينقر المستخدم على عنصر القائمة details_page_fragment، ينتقل التطبيق
تلقائيًا إلى الوجهة المقابلة باستخدام id نفسه.
إضافة لائحة تنقّل
لائحة التنقل هي لوحة في واجهة المستخدم تعرض قائمة التنقل الرئيسية في تطبيقك.
تظهر اللائحة عندما يلمس المستخدم رمز اللائحة
في شريط التطبيق أو عندما يمرر المستخدم إصبعه من الحافة اليسرى
للشاشة.
يظهر رمز الدرج في جميع الوجهات ذات المستوى الأعلى التي تستخدم
DrawerLayout.
لإضافة لائحة تنقل، عليك أولاً تعريف DrawerLayout كعرض
جذري. داخل DrawerLayout، أضِف تنسيقًا لمحتوى واجهة المستخدم الرئيسية
وعرضًا آخر يحتوي على محتوى لائحة التنقل.
على سبيل المثال، يستخدم التنسيق التالي DrawerLayout مع طريقتَي عرض فرعيتَين:
NavHostFragment لاحتواء المحتوى الرئيسي وNavigationView
لمحتوى لائحة التنقل.
<?xml version="1.0" encoding="utf-8"?>
<!-- Use DrawerLayout as root container for activity -->
<androidx.drawerlayout.widget.DrawerLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:id="@+id/drawer_layout"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:fitsSystemWindows="true">
<!-- Layout to contain contents of main body of screen (drawer will slide over this) -->
<androidx.fragment.app.FragmentContainerView
android:name="androidx.navigation.fragment.NavHostFragment"
android:id="@+id/nav_host_fragment"
android:layout_width="match_parent"
android:layout_height="match_parent"
app:defaultNavHost="true"
app:navGraph="@navigation/nav_graph" />
<!-- Container for contents of drawer - use NavigationView to make configuration easier -->
<com.google.android.material.navigation.NavigationView
android:id="@+id/nav_view"
android:layout_width="wrap_content"
android:layout_height="match_parent"
android:layout_gravity="start"
android:fitsSystemWindows="true" />
</androidx.drawerlayout.widget.DrawerLayout>
بعد ذلك، اربط DrawerLayout بالرسم البياني للتنقّل من خلال تمريره إلى
AppBarConfiguration، كما هو موضّح في المثال التالي:
Kotlin
val appBarConfiguration = AppBarConfiguration(navController.graph, drawerLayout)
Java
AppBarConfiguration appBarConfiguration =
new AppBarConfiguration.Builder(navController.getGraph())
.setDrawerLayout(drawerLayout)
.build();
بعد ذلك، في فئة النشاط الرئيسية، يمكنك استدعاء setupWithNavController() من
إجراء onCreate() الخاص بالنشاط الرئيسي، كما هو موضّح أدناه:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) {
setContentView(R.layout.activity_main)
...
val navHostFragment =
supportFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
val navController = navHostFragment.navController
findViewById<NavigationView>(R.id.nav_view)
.setupWithNavController(navController)
}
Java
@Override
protected void onCreate(Bundle savedInstanceState) {
setContentView(R.layout.activity_main);
...
NavHostFragment navHostFragment = supportFragmentManager.findFragmentById(R.id.nav_host_fragment);
NavController navController = navHostFragment.getNavController();
NavigationView navView = findViewById(R.id.nav_view);
NavigationUI.setupWithNavController(navView, navController);
}
اعتبارًا من الإصدار Navigation 2.4.0-alpha01، يتم حفظ حالة كل عنصر في القائمة واستعادتها عند استخدام setupWithNavController.
شريط التنقّل السفلي
يمكن لـ "NavigationUI" أيضًا التعامل مع شريط التنقّل السفلي. عندما يختار المستخدم عنصرًا من القائمة، يستدعي NavController onNavDestinationSelected() ويعدِّل تلقائيًا العنصر المحدّد في شريط التنقّل السفلي.
لإنشاء شريط تنقّل سفلي في تطبيقك، عليك أولاً تحديد الشريط في نشاطك الرئيسي، كما هو موضّح أدناه:
<LinearLayout> ... <androidx.fragment.app.FragmentContainerView android:id="@+id/nav_host_fragment" ... /> <com.google.android.material.bottomnavigation.BottomNavigationView android:id="@+id/bottom_nav" app:menu="@menu/menu_bottom_nav" /> </LinearLayout>
بعد ذلك، في فئة النشاط الرئيسية، يمكنك استدعاء setupWithNavController() من
إجراء onCreate() الخاص بالنشاط الرئيسي، كما هو موضّح أدناه:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) {
setContentView(R.layout.activity_main)
...
val navHostFragment =
supportFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
val navController = navHostFragment.navController
findViewById<BottomNavigationView>(R.id.bottom_nav)
.setupWithNavController(navController)
}
Java
@Override
protected void onCreate(Bundle savedInstanceState) {
setContentView(R.layout.activity_main);
...
NavHostFragment navHostFragment = supportFragmentManager.findFragmentById(R.id.nav_host_fragment);
NavController navController = navHostFragment.getNavController();
BottomNavigationView bottomNav = findViewById(R.id.bottom_nav);
NavigationUI.setupWithNavController(bottomNav, navController);
}
اعتبارًا من الإصدار Navigation 2.4.0-alpha01، يتم حفظ حالة كل عنصر في القائمة واستعادتها عند استخدام setupWithNavController.
الاستماع إلى أحداث التنقّل
يُعد التفاعل مع NavController هو الطريقة الأساسية للتنقل
بين الوجهات. يتحمّل NavController مسؤولية استبدال محتوى NavHost بالوجهة الجديدة. في كثير من الحالات، تكون عناصر واجهة المستخدم، مثل شريط التطبيقات العلوي أو عناصر التحكّم الأخرى في التنقّل الثابت مثل BottomNavigationBar، خارج NavHost ويجب تعديلها أثناء التنقّل بين الوجهات.
يوفّر NavController واجهة OnDestinationChangedListener يتم استدعاؤها عند تغيير الوجهة الحالية لـ NavController أو وسيطاتها. يمكن تسجيل مستمع جديد باستخدام طريقة
addOnDestinationChangedListener(). يُرجى العِلم أنّه عند استدعاء
addOnDestinationChangedListener()، إذا كانت الوجهة الحالية متوفّرة، يتم
إرسالها على الفور إلى المستمع.
يستخدم NavigationUI OnDestinationChangedListener لجعل مكوّنات واجهة المستخدم الشائعة هذه متوافقة مع التنقّل. يُرجى العِلم أنّه يمكنك أيضًا استخدام
OnDestinationChangedListener بمفرده لإعلام أي واجهة مستخدم مخصّصة أو منطق
نشاط تجاري بأحداث التنقّل.
على سبيل المثال، قد يكون لديك عناصر في واجهة المستخدم شائعة تنوي عرضها في بعض مناطق تطبيقك مع إخفائها في مناطق أخرى. باستخدام OnDestinationChangedListener الخاص بك، يمكنك إظهار عناصر واجهة المستخدم هذه أو إخفاؤها بشكل انتقائي استنادًا إلى الوجهة المستهدفة، كما هو موضّح في المثال التالي:
Kotlin
navController.addOnDestinationChangedListener { _, destination, _ ->
if(destination.id == R.id.full_screen_destination) {
toolbar.visibility = View.GONE
bottomNavigationView.visibility = View.GONE
} else {
toolbar.visibility = View.VISIBLE
bottomNavigationView.visibility = View.VISIBLE
}
}
Java
navController.addOnDestinationChangedListener(new NavController.OnDestinationChangedListener() {
@Override
public void onDestinationChanged(@NonNull NavController controller,
@NonNull NavDestination destination, @Nullable Bundle arguments) {
if(destination.getId() == R.id.full_screen_destination) {
toolbar.setVisibility(View.GONE);
bottomNavigationView.setVisibility(View.GONE);
} else {
toolbar.setVisibility(View.VISIBLE);
bottomNavigationView.setVisibility(View.VISIBLE);
}
}
});
أدوات تتبّع الأحداث المستندة إلى الوسيطات
كحلّ بديل، يمكنك أيضًا استخدام الوسيطات مع القيم التلقائية ضمن
الرسم البياني للتنقّل، والذي يمكن استخدامه من خلال وحدة التحكّم المناسبة في واجهة المستخدم
لتعديل حالتها. على سبيل المثال، بدلاً من إنشاء المنطق في
OnDestinationChangedListener استنادًا إلى رقم تعريف الوجهة كما في المثال
السابق، يمكننا إنشاء وسيطة في NavGraph:
<?xml version="1.0" encoding="utf-8"?> <navigation xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" android:id="@+id/navigation\_graph" app:startDestination="@id/fragmentOne"> <fragment android:id="@+id/fragmentOne" android:name="com.example.android.navigation.FragmentOne" android:label="FragmentOne"> <action android:id="@+id/action\_fragmentOne\_to\_fragmentTwo" app:destination="@id/fragmentTwo" /> </fragment> <fragment android:id="@+id/fragmentTwo" android:name="com.example.android.navigation.FragmentTwo" android:label="FragmentTwo"> <argument android:name="ShowAppBar" android:defaultValue="true" /> </fragment> </navigation>
لا يتم استخدام هذه الوسيطة عند الانتقال إلى الوجهة، بل كطريقة لإرفاق معلومات إضافية بالوجهة باستخدام defaultValue. في هذه الحالة، تشير القيمة إلى ما إذا كان يجب عرض شريط التطبيق عند الانتقال إلى هذه الوجهة.
يمكننا الآن إضافة OnDestinationChangedListener في Activity:
Kotlin
navController.addOnDestinationChangedListener { _, _, arguments ->
appBar.isVisible = arguments?.getBoolean("ShowAppBar", false) == true
}
Java
navController.addOnDestinationChangedListener(
new NavController.OnDestinationChangedListener() {
@Override
public void onDestinationChanged(
@NonNull NavController controller,
@NonNull NavDestination destination,
@Nullable Bundle arguments
) {
boolean showAppBar = false;
if (arguments != null) {
showAppBar = arguments.getBoolean("ShowAppBar", false);
}
if(showAppBar) {
appBar.setVisibility(View.VISIBLE);
} else {
appBar.setVisibility(View.GONE);
}
}
}
);
يستدعي NavController دالة ردّ الاتصال هذه كلما تغيّرت وجهة التنقّل. يمكن الآن لـ Activity تعديل حالة أو مستوى ظهور مكوّنات واجهة المستخدم التي يملكها استنادًا إلى الوسيطات التي تم تلقّيها في دالة الاستدعاء.
من مزايا هذا النهج أنّ Activity لا يرى سوى
الوسيطات في الرسم البياني للتنقّل ولا يعرف أدوار ومسؤوليات Fragment
الفردية. وبالمثل، لا تعرف الأجزاء الفردية
عن Activity المحتوي ومكونات واجهة المستخدم التي يمتلكها.
مراجع إضافية
لمعرفة المزيد حول التنقل، راجع الموارد الإضافية التالية.
اختبارات الرموز
منشورات المدوّنات
الفيديوهات
- أفضل 10 ممارسات للانتقال إلى نشاط واحد
- النشاط الفردي: الأسباب والمواعيد والآلية (مؤتمر Android Dev Summit لعام 2018)
- Android Jetpack: إدارة التنقّل في واجهة المستخدم باستخدام Navigation Controller (مؤتمر Google I/O لعام 2018)