أشرطة التطبيقات هي حاويات تتيح للمستخدم الوصول إلى الميزات الرئيسية وعناصر التنقل. هناك نوعان من أشرطة التطبيقات، أشرطة التطبيقات العلوية وأشرطة التطبيقات السفلية. وفي ما يلي مظهر كل منها والغرض منه:
النوع |
المظهر |
الغرض |
|---|---|---|
شريط التطبيق العلوي |
في أعلى الشاشة |
تتيح الوصول إلى المهام والمعلومات الرئيسية. يستضيف بشكل عام عنوانًا وبنود عمل أساسية وبعض عناصر التنقّل. |
شريط التطبيق السفلي |
في أسفل الشاشة |
يتضمّن عادةً عناصر التنقّل الأساسية. وقد يوفّر أيضًا إمكانية الوصول إلى إجراءات رئيسية أخرى، مثل زر الإجراء الرئيسي المضمَّن. |
لتنفيذ شريط تطبيق علوي وشريط تطبيق سفلي، استخدِم الدالتين المركّبتين TopAppBar وBottomAppBar على التوالي. وتتيح لك إنشاء واجهات متّسقة تتضمّن عناصر التحكّم في التنقّل والإجراءات، وتتوافق مع مبادئ التصميم المتعدد الأبعاد.
أشرطة التطبيقات العلوية
يوضّح الجدول التالي الأنواع الأربعة لأشرطة التطبيقات العلوية:
النوع |
مثال |
|---|---|
صغير: للشاشات التي لا تتطلّب الكثير من التنقّل أو الإجراءات |
|
محاذاة للوسط: للشاشات التي تتضمّن إجراءً رئيسيًا واحدًا |
|
متوسط: للشاشات التي تتطلّب قدرًا متوسطًا من التنقّل والإجراءات. |
|
كبير: للشاشات التي تتطلّب الكثير من التنقّل والإجراءات |
|
مساحة عرض واجهة برمجة التطبيقات
تتشابه الدوال المركّبة المختلفة التي تتيح لك تنفيذ أشرطة التطبيقات العلوية الأربعة المختلفة إلى حد كبير. وتتشارك هذه العناصر في عدة مَعلمات رئيسية:
-
title: النص الذي يظهر في شريط التطبيق -
navigationIcon: الرمز الأساسي للتنقّل يظهر على يسار شريط التطبيق. actions: رموز تتيح للمستخدم الوصول إلى الإجراءات الرئيسية وتظهر على يمين شريط التطبيق.-
scrollBehavior: تحدّد هذه السمة كيفية استجابة شريط التطبيق العلوي للتمرير في المحتوى الداخلي للإطار. -
colors: يحدّد هذا الإعداد كيفية ظهور شريط التطبيق.
سلوك الانتقال
يمكنك التحكّم في كيفية استجابة شريط التطبيق عندما ينتقل المستخدم للأسفل أو للأعلى في المحتوى الداخلي
للسقالة المحدّدة. لإجراء ذلك، أنشئ مثيلاً من
TopAppBarScrollBehavior ومرِّره إلى شريط التطبيقات العلوي للمَعلمة
scrollBehavior.
هناك ثلاثة أنواع من TopAppBarScrollBehavior. وهي على النحو التالي:
-
enterAlwaysScrollBehavior: عندما يسحب المستخدم المحتوى الداخلي للسقالة للأعلى، يتم تصغير شريط التطبيق العلوي. يتسع شريط التطبيق عندما يبدأ المستخدم في سحب المحتوى الداخلي لأسفل. exitUntilCollapsedScrollBehavior: يشبهenterAlwaysScrollBehavior، إلا أنّ شريط التطبيق لا يتوسّع إلا عندما يسحب المستخدم المحتوى إلى الأسفل بالكامل.pinnedScrollBehavior: يظل شريط التطبيق في مكانه ولا يتفاعل مع التمرير.
تنفّذ الأمثلة التالية العديد من هذه الخيارات.
أمثلة
توضّح الأقسام التالية عمليات تنفيذ الأنواع الأربعة المختلفة من أشرطة التطبيقات العلوية، بما في ذلك أمثلة مختلفة على كيفية التحكّم في سلوك الانتقال للأعلى أو للأسفل.
صغير
لإنشاء شريط تطبيقات علوي صغير، استخدِم الدالة المركّبة TopAppBar. ينفّذ المثال التالي شريط تطبيق علويًا أساسيًا يحتوي على عنوان فقط.
لا يمرّر المثال التالي قيمة TopAppBar لـ scrollBehavior، وبالتالي لا يتفاعل مع الانتقال في المحتوى الداخلي.
@Composable fun SmallTopAppBarExample() { Scaffold( topBar = { TopAppBar( colors = TopAppBarDefaults.topAppBarColors( containerColor = MaterialTheme.colorScheme.primaryContainer, titleContentColor = MaterialTheme.colorScheme.primary, ), title = { Text("Small Top App Bar") } ) }, ) { innerPadding -> ScrollContent(innerPadding) } }
يظهر هذا التنفيذ على النحو التالي:
محاذاة للوسط
شريط التطبيق العلوي المحاذي للوسط هو نفسه شريط التطبيق الصغير،
على الرغم من أن العنوان يتوسط المكون. لتنفيذها، استخدِم الدالة المركّبة المخصّصة CenterAlignedTopAppBar.
يستخدم هذا المثال enterAlwaysScrollBehavior() للحصول على القيمة التي يمررها
لـ scrollBehavior. وبالتالي، يتم تصغير الشريط عندما ينتقل المستخدم إلى المحتوى الداخلي للإطار.
@Composable fun CenterAlignedTopAppBarExample() { val scrollBehavior = TopAppBarDefaults.pinnedScrollBehavior(rememberTopAppBarState()) Scaffold( modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection), topBar = { CenterAlignedTopAppBar( colors = TopAppBarDefaults.topAppBarColors( containerColor = MaterialTheme.colorScheme.primaryContainer, titleContentColor = MaterialTheme.colorScheme.primary, ), title = { Text( "Centered Top App Bar", maxLines = 1, overflow = TextOverflow.Ellipsis ) }, navigationIcon = { IconButton(onClick = { /* do something */ }) { Icon( painter = rememberVectorPainter(AppIcons.ArrowBack), contentDescription = "Localized description" ) } }, actions = { IconButton(onClick = { /* do something */ }) { Icon( painter = rememberVectorPainter(AppIcons.Menu), contentDescription = "Localized description" ) } }, scrollBehavior = scrollBehavior, ) }, ) { innerPadding -> ScrollContent(innerPadding) } }
يظهر هذا التنفيذ على النحو التالي:
متوسط
يضع شريط التطبيق العلوي المتوسط العنوان أسفل أي أيقونات إضافية. لإنشاء
واحد، استخدِم الدالة البرمجية المركّبة MediumTopAppBar.
مثل المقتطف السابق، يستخدم هذا المثال enterAlwaysScrollBehavior() للحصول على القيمة التي يمررها لـ scrollBehavior.
@Composable fun MediumTopAppBarExample() { val scrollBehavior = TopAppBarDefaults.enterAlwaysScrollBehavior(rememberTopAppBarState()) Scaffold( modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection), topBar = { MediumTopAppBar( colors = TopAppBarDefaults.topAppBarColors( containerColor = MaterialTheme.colorScheme.primaryContainer, titleContentColor = MaterialTheme.colorScheme.primary, ), title = { Text( "Medium Top App Bar", maxLines = 1, overflow = TextOverflow.Ellipsis ) }, navigationIcon = { IconButton(onClick = { /* do something */ }) { Icon( painter = rememberVectorPainter(AppIcons.ArrowBack), contentDescription = "Localized description" ) } }, actions = { IconButton(onClick = { /* do something */ }) { Icon( painter = rememberVectorPainter(AppIcons.Menu), contentDescription = "Localized description" ) } }, scrollBehavior = scrollBehavior ) }, ) { innerPadding -> ScrollContent(innerPadding) } }
يظهر هذا التنفيذ على النحو التالي، مع عرض توضيحي لكيفية ظهور سلوك الانتقال من enterAlwaysScrollBehavior():
كبير
يشبه شريط التطبيق العلوي الكبير الشريط المتوسط، إلا أنّ المساحة المتروكة بين العنوان والرموز تكون أكبر ويشغل مساحة أكبر على الشاشة بشكل عام. لإنشاء
واحد، استخدِم الدالة المركّبة LargeTopAppBar.
على عكس المقتطفات السابقة، يستخدم هذا المثال
exitUntilCollapsedScrollBehavior() للحصول على القيمة التي يمررها
scrollBehavior. وبالتالي، يتم تصغير الشريط عندما ينتقل المستخدم إلى المحتوى الداخلي في Scaffold، ولكن يتم توسيعه بعد ذلك عندما ينتقل المستخدم إلى نهاية المحتوى الداخلي.
@Composable fun LargeTopAppBarExample() { val scrollBehavior = TopAppBarDefaults.exitUntilCollapsedScrollBehavior(rememberTopAppBarState()) Scaffold( modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection), topBar = { LargeTopAppBar( colors = TopAppBarDefaults.topAppBarColors( containerColor = MaterialTheme.colorScheme.primaryContainer, titleContentColor = MaterialTheme.colorScheme.primary, ), title = { Text( "Large Top App Bar", maxLines = 1, overflow = TextOverflow.Ellipsis ) }, navigationIcon = { IconButton(onClick = { /* do something */ }) { Icon( painter = rememberVectorPainter(AppIcons.ArrowBack), contentDescription = "Localized description" ) } }, actions = { IconButton(onClick = { /* do something */ }) { Icon( painter = rememberVectorPainter(AppIcons.Menu), contentDescription = "Localized description" ) } }, scrollBehavior = scrollBehavior ) }, ) { innerPadding -> ScrollContent(innerPadding) } }
يظهر هذا التنفيذ على النحو التالي:
تحديث M3 Expressive
يأتي شريطا التطبيقات الجديدان المتوسط المرن والكبير المرن مع تحسينات كبيرة، مثل الارتفاعات المرنة، ودعم الأسطر المتعددة، والنص الموسط. ويمكن أن تحتوي أيضًا على مجموعة متنوعة من العناصر، مثل الصور. يُنصح باستخدام أشرطة التطبيقات المرنة المتوسطة والكبيرة بدلاً من أشرطة التطبيقات المتوسطة والكبيرة. تم تعديل شريط التطبيقات الصغير ليشمل التحسينات المرنة نفسها.
لمزيد من المعلومات حول تعديلات M3 Expressive لأشرطة التطبيقات، يُرجى الاطّلاع على إرشادات أشرطة التطبيقات في التصميم المتعدد الأبعاد 3.
محاذاة للوسط واليسار
| صغير | ![]() |
|---|---|
![]() |
|
| متوسط |
![]() |
![]() |
|
| كبير | ![]() |
![]() |
يمكن محاذاة العناوين الرئيسية الصغيرة والمتوسطة المرنة والكبيرة المرنة مع الحافة الأمامية أو توسيطها.
يوضّح المقتطف التالي كيفية تنفيذ شريط تطبيق علوي محاذٍ للوسط مع عنوان فرعي:
@OptIn(ExperimentalMaterial3Api::class) @Composable fun SimpleCenterAlignedTopAppBarWithSubtitle() { val scrollBehavior = TopAppBarDefaults.pinnedScrollBehavior() Scaffold( modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection), topBar = { TopAppBar( title = { Text("Simple TopAppBar", maxLines = 1, overflow = TextOverflow.Ellipsis) }, subtitle = { Text("Subtitle", maxLines = 1, overflow = TextOverflow.Ellipsis) }, titleHorizontalAlignment = Alignment.CenterHorizontally, navigationIcon = { IconButton(onClick = { /* onBackClick() */ }) { Icon( painter = rememberVectorPainter(AppIcons.ArrowBack), contentDescription = "Localized description", ) } }, actions = { IconButton(onClick = { /* doSomething() */ }) { Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Localized description") } }, scrollBehavior = scrollBehavior, ) }, content = { innerPadding -> // ... }, ) }
سلوك الانتقال
الدخول دائمًا
عندما يقوم المستخدم بالتمرير لأسفل عبر المحتوى (سحب المحتوى لأعلى)، ينهار شريط التطبيق على الفور. عندما ينتقل المستخدم للأعلى (سحب المحتوى للأسفل)، يتوسّع شريط التطبيق على الفور، بغض النظر عن مكان المستخدم في قائمة المحتوى القابل للتمرير.
يوضّح المقتطف التالي كيفية تنفيذ شريط تطبيق علوي يتضمّن سلوك التنقّل enter-always:
@OptIn(ExperimentalMaterial3Api::class) @Composable fun EnterAlwaysTopAppBar() { val scrollBehavior = TopAppBarDefaults.enterAlwaysScrollBehavior() Scaffold( modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection), topBar = { TopAppBar( title = { Text("TopAppBar", maxLines = 1, overflow = TextOverflow.Ellipsis) }, subtitle = { Text("Subtitle", maxLines = 1, overflow = TextOverflow.Ellipsis) }, navigationIcon = { IconButton(onClick = { /* onBackClick() */ }) { Icon( painter = rememberVectorPainter(AppIcons.ArrowBack), contentDescription = "Localized description", ) } }, actions = { IconButton(onClick = { /* doSomething() */ }) { Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Localized description") } }, scrollBehavior = scrollBehavior, ) }, content = { innerPadding -> // ... }, ) }
يعرض الفيديو التالي نتيجة المقتطف السابق:
الخروج حتى التصغير
عندما ينتقل المستخدم للأسفل في المحتوى (سحب المحتوى للأعلى)، يتم تصغير أشرطة التطبيقات المرنة المتوسطة والكبيرة حتى يظل شريط التطبيقات المصغّر فقط مرئيًا. عندما ينتقل المستخدم للأعلى (سحب المحتوى للأسفل)، يظل شريط التطبيق مصغّرًا حتى يصل المستخدم إلى أعلى المحتوى، وعندها يتوسّع شريط التطبيق مرة أخرى إلى ارتفاعه الكامل، ويتوسّط مع العنوان الفرعي.
مرونة متوسطة
يوضّح المقتطف التالي كيفية تنفيذ شريط تطبيقات علوي مرن متوسط الحجم مع سلوك التمرير "الخروج حتى التصغير":
@OptIn(ExperimentalMaterial3Api::class) @Composable fun ExitUntilCollapsedCenterAlignedMediumFlexibleTopAppBar() { val scrollBehavior = TopAppBarDefaults.exitUntilCollapsedScrollBehavior() Scaffold( modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection), topBar = { MediumFlexibleTopAppBar( title = { Text("Medium TopAppBar", maxLines = 1, overflow = TextOverflow.Ellipsis) }, subtitle = { Text("Subtitle", maxLines = 1, overflow = TextOverflow.Ellipsis) }, titleHorizontalAlignment = Alignment.CenterHorizontally, navigationIcon = { IconButton(onClick = { /* onBackClick() */ }) { Icon( painter = rememberVectorPainter(AppIcons.ArrowBack), contentDescription = "Localized description", ) } }, actions = { IconButton(onClick = { /* doSomething() */ }) { Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Localized description") } }, scrollBehavior = scrollBehavior, ) }, content = { innerPadding -> // ... }, ) }
يعرض الفيديو التالي نتيجة المقتطف السابق:
مرن كبير
يوضّح المقتطف التالي كيفية تنفيذ شريط تطبيقات علوي كبير ومرن مع سلوك التمرير "الخروج حتى التصغير":
@OptIn(ExperimentalMaterial3Api::class) @Composable fun ExitUntilCollapsedCenterAlignedLargeFlexibleTopAppBar() { val scrollBehavior = TopAppBarDefaults.exitUntilCollapsedScrollBehavior() Scaffold( modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection), topBar = { LargeFlexibleTopAppBar( title = { Text("Large TopAppBar", maxLines = 1, overflow = TextOverflow.Ellipsis) }, subtitle = { Text("Subtitle", maxLines = 1, overflow = TextOverflow.Ellipsis) }, titleHorizontalAlignment = Alignment.CenterHorizontally, navigationIcon = { IconButton(onClick = { /* onBackClick() */ }) { Icon( painter = rememberVectorPainter(AppIcons.ArrowBack), contentDescription = "Localized description", ) } }, actions = { IconButton(onClick = { /* doSomething() */ }) { Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Localized description") } }, scrollBehavior = scrollBehavior, ) }, content = { innerPadding -> // ... }, ) }
يعرض الفيديو التالي نتيجة المقتطف السابق:
شريط التطبيق السفلي
لإنشاء شريط تطبيق سفلي، استخدِم الدالة المركّبة BottomAppBar. يشبه استخدام هذه الدالة المركّبة دوال شريط التطبيق العلوي المركّبة الموضّحة في الأقسام السابقة من هذه الصفحة. يمكنك تمرير الدوال المركّبة للمَعلمات الرئيسية التالية:
actions: سلسلة من الرموز التي تظهر على يمين الشريط وهي عادةً إما إجراءات رئيسية للشاشة المحددة أو عناصر تنقّل.-
floatingActionButton: زر الإجراء الرئيسي الذي يظهر على الجانب الأيمن من الشريط
@Composable fun BottomAppBarExample() { Scaffold( bottomBar = { BottomAppBar( actions = { IconButton(onClick = { /* do something */ }) { Icon(painter = rememberVectorPainter(AppIcons.Check), contentDescription = "Localized description") } IconButton(onClick = { /* do something */ }) { Icon( painter = rememberVectorPainter(AppIcons.Edit), contentDescription = "Localized description", ) } IconButton(onClick = { /* do something */ }) { Icon( painter = rememberVectorPainter(AppIcons.Mic), contentDescription = "Localized description", ) } IconButton(onClick = { /* do something */ }) { Icon( painter = rememberVectorPainter(AppIcons.Image), contentDescription = "Localized description", ) } }, floatingActionButton = { FloatingActionButton( onClick = { /* do something */ }, containerColor = BottomAppBarDefaults.bottomAppBarFabColor, elevation = FloatingActionButtonDefaults.bottomAppBarFabElevation() ) { Icon(painter = rememberVectorPainter(AppIcons.Add), "Localized description") } } ) }, ) { innerPadding -> Text( modifier = Modifier.padding(innerPadding), text = "Example of a scaffold with a bottom app bar." ) } }
يظهر هذا التنفيذ على النحو التالي:
تحديث M3 Expressive
في Material 3 Expressive، استخدِم شريط الأدوات الثابت
(FlexibleBottomAppBar) بدلاً من شريط التطبيق السفلي العادي للحصول على
ارتفاع أقصر وترتيب أفقي أكثر مرونة للعناصر.
ينفّذ المقتطف التالي FlexibleBottomAppBar مع AppBarRow ينقل بنود العمل الإضافية إلى قائمة الكاملة عندما تكون المساحة محدودة:
@Composable fun FlexibleBottomAppBarSample() { val icons = listOf( AppIcons.ArrowBack, AppIcons.ArrowForward, AppIcons.Add, AppIcons.Check, AppIcons.Edit, AppIcons.Favorite, ) val items = listOf("Back", "Forward", "Add", "Check", "Edit", "Favorite") FlexibleBottomAppBar( contentPadding = PaddingValues(horizontal = 96.dp), horizontalArrangement = BottomAppBarDefaults.FlexibleFixedHorizontalArrangement, ) { AppBarRow( overflowIndicator = { menuState -> IconButton( onClick = { if (menuState.isShowing) { menuState.dismiss() } else { menuState.show() } } ) { Icon( painter = rememberVectorPainter(AppIcons.MoreVert), contentDescription = "Overflow", ) } } ) { items.forEachIndexed { index, item -> clickableItem( onClick = { /* doSomething() */ }, icon = { Icon( painter = rememberVectorPainter(icons[index]), contentDescription = item, ) }, label = item, ) } } } }





