نوار برنامه محفظهای است که دسترسی کاربر به ویژگیهای کلیدی و موارد پیمایش را فراهم میکند. دو نوع نوار برنامه وجود دارد: نوار برنامه بالا و نوار برنامه پایین. ظاهر و هدف هرکدام به شرح زیر است:
نوع |
ظاهر |
هدف |
|---|---|---|
نوار برنامه بالا |
در بالای صفحه. |
دسترسی به اطلاعات و تکالیف کلیدی را فراهم میکند. معمولاً میزبان عنوان، دستورهای اقدام اصلی، و برخی موارد پیمایش است. |
نوار برنامه پایین صفحه |
در پایین صفحه. |
معمولاً شامل موارد پیمایش اصلی است. همچنین ممکن است دسترسی به کنشهای کلیدی دیگر را فراهم کند، مثلاً ازطریق دکمه کنش شناور موجود. |
برای پیادهسازی نوار برنامه بالا و نوار برنامه پایین، بهترتیب از ترکیبپذیرهای 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 ارسال میکند استفاده میکند. بهاینترتیب، وقتی کاربر محتوای داخلی داربست را پیمایش میکند، نوار جمع میشود، اما وقتی کاربر به انتهای محتوای داخلی پیمایش میکند، نوار گسترش مییابد.
@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 برای نوارهای برنامه، رهنمودهای نوارهای برنامه Material Design 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 -> // ... }, ) }
رفتار پیمایش
همیشه وارد شود
وقتی کاربر در محتوا بهپایین پیمایش میکند (محتوا را بهبالا میکشد)، نوار برنامه فوراً جمع میشود. وقتی کاربر به بالا پیمایش میکند (محتوا را به پایین میکشد)، نوار برنامه بلافاصله گسترش مییابد، صرفنظر از اینکه کاربر در کجای فهرست محتوای قابلپیمایش قرار دارد.
تکهکد زیر نحوه پیادهسازی نوار برنامه بالایی را با رفتار پیمایش «همیشه وارد شدن» نشان میدهد:
@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 استفاده کنید. استفاده از این
composable شبیه به composableهای نوار برنامه بالا است که در بخشهای قبلی
این صفحه شرح داده شده است. شما composableها را برای پارامترهای کلیدی زیر ارسال میکنید:
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, ) } } } }





