يحتاج المستخدمون إلى طريقة سهلة للعودة إلى الشاشة الرئيسية لتطبيقك. لإجراء ذلك، يجب توفير زر الانتقال للأعلى في شريط التطبيق
لجميع الأنشطة باستثناء النشاط الرئيسي. عندما يختار المستخدم الزر "الانتقال للأعلى"، ينتقل التطبيق إلى
النشاط الرئيسي.
ضبط شريط التطبيقات باستخدام
AppBarConfiguration.
من AppBarConfiguration، يمكنك إبلاغ شريط التطبيق بوجهة المستوى الأعلى. في حال ضبط درج التنقل، يظهر رمز قائمة الدرج
في شريط
التطبيق على الوجهات ذات المستوى الأعلى. في حال عدم ضبط لائحة التنقل، يتم
إخفاء زرّ التنقّل في الوجهات ذات المستوى الأعلى.
في كلتا الحالتَين، يظهر الزر "أعلى" على جميع الوجهات الأخرى. يؤدي الضغط على الزر للأعلى إلى استدعاء
navigateUp().
يوضّح المثال التالي كيفية ضبط شريط تطبيق باستخدام
AppBarConfiguration:
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Add an Up action\n\nTry the Compose way \nJetpack Compose is the recommended UI toolkit for Android. Learn how to add components in Compose. \n[Navigate from top app bar →](/develop/ui/compose/components/app-bars-navigate) \n\nUsers need an easy way to get back to your app's main screen. To do this, provide an *Up*\nbutton on the app bar\nfor all activities except the main one. When the user selects the Up button, the app navigates to\nthe parent activity.\n\nThis page shows you how to add an Up button to an app bar using the Jetpack Navigation component.\nFor a more detailed explanation, see\n[Update UI components with NavigationUI](/guide/navigation/navigation-ui).\n| **Note:** We recommend using the Jetpack Navigation component to handle your app navigation. This component handles navigating up from the current screen in your app when the user taps the Up button. To learn more, see the documentation for the [Jetpack Navigation component](/guide/navigation).\n\nConfigure your app bar\n----------------------\n\nConfigure your app bar using an\n[AppBarConfiguration](/reference/androidx/navigation/ui/AppBarConfiguration).\nFrom the `AppBarConfiguration`, you can inform the app bar of your top-level\ndestinations. If the navigation drawer is configured, the drawer menu icon\ndisplays on the app\nbar on top-level destinations. If the navigation drawer isn't configured, the navigation button is\nhidden on top-level destinations.\n\nIn both cases, the Up button displays on all other destinations. Pressing the Up button calls\n[navigateUp()](/reference/androidx/navigation/NavController#navigateUp()).\n\nThe following example shows how to configure an app bar using\n`AppBarConfiguration`: \n\n### Kotlin\n\n```kotlin\n override fun onCreate(savedInstanceState: Bundle?) {\n ...\n val navController = findNavController(R.id.nav_host_fragment_activity_main)\n \n val appBarConfiguration = AppBarConfiguration(\n setOf(\n R.id.navigation_home, R.id.navigation_dashboard, R.id.navigation_notifications\n )\n )\n binding.myToolbar.setupWithNavController(navController, appBarConfiguration)\n }\n \n```\n\n### Java\n\n```java\n @Override\n protected void onCreate(Bundle savedInstanceState) {\n ...\n NavController navController = Navigation.findNavController(this, R.id.nav_host_fragment_activity_main);\n\n AppBarConfiguration appBarConfiguration = new AppBarConfiguration.Builder(\n R.id.navigation_home, R.id.navigation_dashboard, R.id.navigation_notifications)\n .build();\n NavigationUI.setupWithNavController(binding.myToolbar, navController, appBarConfiguration);\n }\n \n```"]]