يظهر شريط الأدوات العائم فوق محتوى النص. ويُفضَّل استخدامه للإجراءات المستندة إلى السياق ذات الصلة بمحتوى النص أو الصفحة المحدّدة.
يمكنك وضع شريط أدوات عائم في أي مكان على الشاشة ليطفو فوق بقية المحتوى، مما يوفر موضعًا ومساحة متعددة الاستخدامات لإجراءات متعددة.
استخدام شريط الأدوات العائم
- تعرض أشرطة الأدوات العائمة عناصر التحكّم ذات الصلة بالصفحة الحالية.
- يمكن أن تعمل أشرطة الأدوات العائمة كعناصر تحكّم في التنقّل بين الصفحات ذات الصلة في التسلسل الهرمي للمنتج.
- إذا كانت هناك حاجة إلى المزيد من الإجراءات، استخدِم قائمة الكاملة.
- يجب أن تظل حاوية شريط الأدوات العائم مرئية بالكامل على الشاشة.
- اختَر الإجراءات الأكثر أهمية لعرضها على الشاشة تلقائيًا.
التنسيق والألوان
يمكن أن تكون أشرطة الأدوات العائمة أفقية (HorizontalFloatingToolbar) أو
عمودية (VerticalFloatingToolbar)، ويمكن أن تستخدم أنظمة ألوان عادية أو
نابضة بالحياة من FloatingToolbarDefaults.
شريط أدوات عائم مع زر إجراء عائم
استخدِم زر الإجراء الرئيسي (FAB) المصاحب للإجراء ذي الأولوية القصوى في العرض، أو لتكملة عناصر التحكّم في شريط الأدوات.
أمثلة
شريط أدوات عائم أفقي قابل للتوسيع
يمكنك تطبيق Modifier.floatingToolbarVerticalNestedScroll على حاوية قابلة للتمرير
ليتم تصغير الإجراءات في بداية HorizontalFloatingToolbar ونهايتها تلقائيًا عندما يمرّر المستخدم الشاشة للأسفل، وتوسيعها عند التمرير للأعلى:
@Composable fun ExpandableHorizontalFloatingToolbarSample() { var expanded by rememberSaveable { mutableStateOf(true) } Scaffold { innerPadding -> Box(Modifier.padding(innerPadding)) { HorizontalFloatingToolbar( modifier = Modifier.align(Alignment.BottomCenter) .offset(y = -FloatingToolbarDefaults.ScreenOffset) .zIndex(1f), expanded = expanded, leadingContent = { IconButton(onClick = { /* doSomething() */ }) { Icon(painter = rememberVectorPainter(AppIcons.Edit), contentDescription = "Edit") } IconButton(onClick = { /* doSomething() */ }) { Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Favorite") } }, trailingContent = { IconButton(onClick = { /* doSomething() */ }) { Icon(painter = rememberVectorPainter(AppIcons.Share), contentDescription = "Share") } }, content = { FilledIconButton( modifier = Modifier.width(64.dp), onClick = { /* doSomething() */ }, ) { Icon(painter = rememberVectorPainter(AppIcons.Add), contentDescription = "Add") } }, ) // ... } } }
شريط أدوات عائم عمودي قابل للتوسيع
استخدِم VerticalFloatingToolbar مثبَّتًا على جانب الشاشة عندما
تكون مساحة التنسيق العمودي مناسبة للتسلسل الهرمي للشاشة. مثل الشريط الأفقي،
يمكن توسيعه وتصغيره استجابةً لإيماءات الانتقال:
@Composable fun ExpandableVerticalFloatingToolbarSample() { var expanded by rememberSaveable { mutableStateOf(true) } Scaffold { innerPadding -> Box(Modifier.padding(innerPadding)) { VerticalFloatingToolbar( modifier = Modifier.align(Alignment.CenterEnd) .offset(x = -FloatingToolbarDefaults.ScreenOffset) .zIndex(1f), expanded = expanded, leadingContent = { IconButton(onClick = { /* doSomething() */ }) { Icon(painter = rememberVectorPainter(AppIcons.Edit), contentDescription = "Edit") } IconButton(onClick = { /* doSomething() */ }) { Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Favorite") } }, trailingContent = { IconButton(onClick = { /* doSomething() */ }) { Icon(painter = rememberVectorPainter(AppIcons.Share), contentDescription = "Share") } }, content = { FilledIconButton( modifier = Modifier.height(64.dp), onClick = { /* doSomething() */ }, ) { Icon(painter = rememberVectorPainter(AppIcons.Add), contentDescription = "Add") } }, ) // ... } } }
شريط أدوات عائم قابل للتمرير
لإزاحة شريط الأدوات العائم بالكامل خارج الشاشة أثناء التمرير بدلاً من
تصغير عناصره، مرِّر FloatingToolbarDefaults.exitAlwaysScrollBehavior إلى
كل من Modifier.nestedScroll ومَعلمة scrollBehavior لشريط الأدوات:
@Composable fun ScrollableHorizontalFloatingToolbarSample() { val exitAlwaysScrollBehavior = FloatingToolbarDefaults.exitAlwaysScrollBehavior( exitDirection = FloatingToolbarExitDirection.Bottom ) Scaffold(modifier = Modifier.nestedScroll(exitAlwaysScrollBehavior)) { innerPadding -> Box(Modifier.padding(innerPadding)) { HorizontalFloatingToolbar( modifier = Modifier.align(Alignment.BottomCenter) .offset(y = -FloatingToolbarDefaults.ScreenOffset) .zIndex(1f), expanded = true, leadingContent = { IconButton(onClick = { /* doSomething() */ }) { Icon(painter = rememberVectorPainter(AppIcons.Edit), contentDescription = "Edit") } IconButton(onClick = { /* doSomething() */ }) { Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Favorite") } }, trailingContent = { IconButton(onClick = { /* doSomething() */ }) { Icon(painter = rememberVectorPainter(AppIcons.Share), contentDescription = "Share") } }, content = { FilledIconButton( modifier = Modifier.width(64.dp), onClick = { /* doSomething() */ }, ) { Icon(painter = rememberVectorPainter(AppIcons.Add), contentDescription = "Add") } }, scrollBehavior = exitAlwaysScrollBehavior, ) // ... } } }