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

يوضح هذا الدليل كيفية إنشاء رمز التنقل في أحد أهم التطبيقات شريط لتنفيذ إجراءات التنقل.

مثال

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

@Composable
fun TopBarNavigationExample(
    navigateBack: () -> Unit,
) {
    Scaffold(
        topBar = {
            CenterAlignedTopAppBar(
                title = {
                    Text(
                        "Navigation example",
                    )
                },
                navigationIcon = {
                    IconButton(onClick = navigateBack) {
                        Icon(
                            imageVector = Icons.AutoMirrored.Filled.ArrowBack,
                            contentDescription = "Localized description"
                        )
                    }
                },
            )
        },
    ) { innerPadding ->
        Text(
            "Click the back button to pop from the back stack.",
            modifier = Modifier.padding(innerPadding),
        )
    }
}
AppBar.kt

النقاط الرئيسية حول الرمز البرمجي

لاحظ ما يلي في هذا المثال:

  • تحدِّد TopBarNavigationExample القابلة للإنشاء المَعلمة navigateBack. من النوع () -> Unit.
  • يمرر navigateBack للمعلمة navigationIcon CenterAlignedTopAppBar

لذلك، عندما ينقر المستخدم على أيقونة التنقل في التطبيق العلوي مرة أخرى، يتصل برقم navigateBack().

تمرير دالة

يستخدم هذا المثال سهم الرجوع للرمز. وعلى هذا النحو، فإن الوسيطة يجب أن تنقل السمة navigateBack() المستخدم إلى الوجهة السابقة.

لإجراء ذلك، عليك تمرير "TopBarNavigationExample" مكالمة إلى NavController.popBackStack() يمكنك القيام بذلك حيث تنشئ الرسم البياني للتنقل. مثلاً:

NavHost(navController, startDestination = "home") {
    composable("topBarNavigationExample") {
        TopBarNavigationExample{ navController.popBackStack() }
    }
    // Other destinations...

مصادر إضافية

لمزيد من المعلومات حول كيفية تنفيذ التنقّل في تطبيقك، اطّلِع على السلسلة التالية من الأدلة: