Pływający przycisk polecenia

Pływający przycisk polecenia (FAB) to przycisk o dużym znaczeniu, który umożliwia użytkownikowi wykonanie głównego działania w aplikacji. Promuje pojedyncze, ukierunkowane działanie, które jest najczęstszą ścieżką, jaką może wybrać użytkownik. Zwykle znajduje się w prawym dolnym rogu ekranu.

Oto 3 przypadki użycia, w których możesz wykorzystać przycisk typu FAB:

  • Tworzenie nowego elementu: w aplikacji do robienia notatek przycisk FAB może służyć do szybkiego tworzenia nowej notatki.
  • Dodaj nowy kontakt: w aplikacji do obsługi czatu przycisk FAB może otwierać interfejs, który umożliwia użytkownikowi dodanie kogoś do rozmowy.
  • Wyśrodkowanie lokalizacji: w interfejsie mapy przycisk FAB może wyśrodkować mapę na bieżącej lokalizacji użytkownika.

W Material Design dostępne są 4 rodzaje przycisków FAB:

  • Pływający przycisk polecenia (FAB): pływający przycisk polecenia o zwykłym rozmiarze.
  • Mały przycisk FAB: mniejszy pływający przycisk polecenia.
  • Duży przycisk typu FAB: większy pływający przycisk polecenia.
  • Rozszerzony przycisk FAB: pływający przycisk polecenia, który zawiera więcej niż tylko ikonę.
Przykłady 4 komponentów pływającego przycisku polecenia.
Rysunek 1. Cztery typy pływającego przycisku polecenia (FAB).

Interfejs API

Chociaż istnieje kilka funkcji kompozycyjnych, których możesz użyć do utworzenia pływających przycisków polecenia zgodnych z Material Design, ich parametry nie różnią się znacząco. Warto zwrócić uwagę na kilka kluczowych parametrów:

  • onClick: funkcja wywoływana, gdy użytkownik naciśnie przycisk.
  • containerColor: kolor przycisku.
  • contentColor: kolor ikony.

pływający przycisk polecenia (FAB)

Aby utworzyć ogólny pływający przycisk polecenia, użyj podstawowej funkcji kompozycyjnej FloatingActionButton. Poniższy przykład pokazuje podstawową implementację przycisku FAB:

@Composable
fun Example(onClick: () -> Unit) {
    FloatingActionButton(
        onClick = { onClick() },
    ) {
        Icon(painter = rememberVectorPainter(AppIcons.Add), "Floating action button.")
    }
}

Implementacja wygląda tak:

Rysunek 2. Pływający przycisk polecenia.

Mały przycisk

Aby utworzyć mały pływający przycisk polecenia, użyj funkcji kompozycyjnej SmallFloatingActionButton. Poniższy przykład pokazuje, jak to zrobić, dodając spersonalizowane kolory.

@Composable
fun SmallExample(onClick: () -> Unit) {
    SmallFloatingActionButton(
        onClick = { onClick() },
        containerColor = MaterialTheme.colorScheme.secondaryContainer,
        contentColor = MaterialTheme.colorScheme.secondary
    ) {
        Icon(painter = rememberVectorPainter(AppIcons.Add), "Small floating action button.")
    }
}

Implementacja wygląda tak:

Rysunek 3. Mały pływający przycisk polecenia.

Duży przycisk

Aby utworzyć duży pływający przycisk polecenia, użyj funkcji kompozycyjnej LargeFloatingActionButton. Ten element kompozycyjny nie różni się znacząco od innych przykładów, poza tym, że tworzy większy przycisk.

Poniżej znajdziesz prostą implementację dużego przycisku FAB.

@Composable
fun LargeExample(onClick: () -> Unit) {
    LargeFloatingActionButton(
        onClick = { onClick() },
        shape = CircleShape,
    ) {
        Icon(painter = rememberVectorPainter(AppIcons.Add), "Large floating action button")
    }
}

Implementacja wygląda tak:

Rysunek 4. Duży pływający przycisk polecenia.

Przycisk rozszerzony

Bardziej złożone pływające przyciski polecenia możesz tworzyć za pomocą funkcji kompozycyjnej ExtendedFloatingActionButton. Główna różnica między tym zdarzeniem a FloatingActionButton polega na tym, że ma ono dedykowane parametry icon i text. Umożliwiają utworzenie przycisku z bardziej złożoną zawartością, która jest odpowiednio skalowana.

Poniższy fragment kodu pokazuje, jak wdrożyć ExtendedFloatingActionButton z przykładowymi wartościami przekazanymi dla icon i text.

@Composable
fun ExtendedExample(onClick: () -> Unit) {
    ExtendedFloatingActionButton(
        onClick = { onClick() },
        icon = { Icon(painter = rememberVectorPainter(AppIcons.Edit), "Extended floating action button.") },
        text = { Text(text = "Extended FAB") },
    )
}

Implementacja wygląda tak:

Rysunek 5. Pływający przycisk polecenia z tekstem i ikoną.

Aktualizacja M3 Expressive

Przycisk typu FAB jest dostępny w dodatkowych rozmiarach, które pasują do rozszerzonego przycisku typu FAB i rozszerzonych opcji kolorów, w tym MediumFloatingActionButton, który jest zalecany w większości sytuacji obok istniejących rozmiarów przycisku typu FAB.

Pływające przyciski polecenia (FAB) z wyrazistymi wariantami kolorów i rozmiarów.
Rysunek 6. Warianty kolorów i rozmiarów pływającego przycisku polecenia Material 3 Expressive.

Więcej informacji o aktualizacjach M3 Expressive dotyczących pływających przycisków polecenia znajdziesz w wytycznych dotyczących pływających przycisków polecenia w Material Design 3.

Średni pływający przycisk polecenia (FAB)

Średni przycisk FAB jest zalecany w większości sytuacji i najlepiej sprawdza się w kompaktowych i średnich oknach. Używaj go do ważnych działań, nie zajmując zbyt dużo miejsca.

Poniższy fragment kodu pokazuje, jak wdrożyć średni pływający przycisk polecenia za pomocą MediumFloatingActionButton:

@Composable
fun MediumFloatingActionButtonSample() {
    MediumFloatingActionButton(onClick = {}) {
        Icon(
            painter = rememberVectorPainter(AppIcons.Add),
            contentDescription = "Add",
            modifier = Modifier.size(FloatingActionButtonDefaults.MediumIconSize),
        )
    }
}

Dodatkowe materiały