Kayan araç çubuğu

Kayan araç çubuğu, gövde içeriğinin üzerinde görünür. Gövde içeriği veya belirli bir sayfayla alakalı bağlamsal işlemler için kullanılması en iyisidir.

Kayan araç çubuğunu, ekranın herhangi bir yerine yerleştirerek içeriğin geri kalanının üzerinde kaymasını sağlayabilirsiniz. Bu sayede, çok yönlü yerleşim ve birden fazla işlem için alan elde edebilirsiniz.

Kayan araç çubuğunu kullanma

  • Kayan araç çubukları, mevcut sayfayla ilgili kontrolleri gösterir.
  • Kayan araç çubukları, bir ürün hiyerarşisindeki ilgili sayfalar arasında gezinme kontrolleri olarak kullanılabilir.
  • Daha fazla işlem gerekiyorsa taşma menüsü kullanın.
  • Kayan araç çubuğunun kapsayıcısı ekranda tamamen görünür olmalıdır.
  • Varsayılan olarak ekranda gösterilecek en önemli işlemleri seçin.

Düzen ve renkler

Kayan araç çubukları yatay (HorizontalFloatingToolbar) veya dikey (VerticalFloatingToolbar) olabilir ve FloatingToolbarDefaults'teki standart veya canlı renk şemalarını kullanabilir.

Açık tema yatay kayan araç çubuğu  Açık tema dikey kayan araç çubuğu 
Şekil 1. Yatay ve dikey kayan araç çubukları.

FAB içeren kayan araç çubuğu

Görünümdeki en yüksek öncelikli işlem için veya araç çubuğunun kontrollerini tamamlamak amacıyla eşlik eden bir kayan işlem düğmesi (FAB) kullanın.

FAB içeren açık tema yatay kayan araç çubuğu  FAB ile açık tema dikey kayan araç çubuğu 
Şekil 2. FAB içeren kayan araç çubukları.

Örnekler

Genişletilebilir yatay kayan araç çubuğu

Modifier.floatingToolbarVerticalNestedScroll öğesini kaydırılabilir bir kapsayıcıya uygulayın. Böylece HorizontalFloatingToolbar, kullanıcı aşağı kaydırdığında baştaki ve sondaki işlemlerini otomatik olarak daraltır, yukarı kaydırdığında ise genişletir:

@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")
                    }
                },
            )
            // ...
        }
    }
}

Genişletilebilir dikey kayan araç çubuğu

Dikey düzen alanı ekran hiyerarşinize uygun olduğunda ekranın yan tarafına sabitlenmiş VerticalFloatingToolbar kullanın. Yatay varyant gibi, kaydırma hareketlerine yanıt olarak genişleyip daralabilir:

@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")
                    }
                },
            )
            // ...
        }
    }
}

Kaydırılabilir kayan araç çubuğu

Kaydırma sırasında öğelerini daraltmak yerine kayan araç çubuğunun tamamını ekranın dışına kaydırmak için hem Modifier.nestedScroll hem de araç çubuğunun scrollBehavior parametresine FloatingToolbarDefaults.exitAlwaysScrollBehavior değerini iletin:

@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,
            )
            // ...
        }
    }
}