Przyciski ikon wyświetlają działania, które użytkownicy mogą wykonać. Przyciski ikon muszą używać ikony o jasnym znaczeniu i zwykle reprezentują typowe lub często używane działania.
Istnieją 2 rodzaje przycisków ikon:
- Domyślne: te przyciski mogą otwierać inne elementy, takie jak menu lub wyszukiwanie.
- Przełącznik: te przyciski mogą reprezentować działania binarne, które można włączać i wyłączać, takie jak „ulubione” lub „zakładka”.
Interfejs API
Użyj funkcji kompozycyjnej IconButton, aby zaimplementować standardowe przyciski ikon, oraz IconToggleButton, aby utworzyć przycisk, który przełącza się między stanem zaznaczonym i niezaznaczonym. Aby utworzyć różne style wizualne, takie jak wypełniony, wypełniony tonalnie lub konturowy, użyj FilledIconButton, FilledTonalIconButton i OutlinedIconButton lub ich odpowiedników z przełącznikiem FilledIconToggleButton, FilledTonalIconToggleButton i OutlinedIconToggleButton.
Najważniejsze parametry IconButton to:
onClick: funkcja lambda, która jest wykonywana, gdy użytkownik kliknie przycisk ikony.enabled: wartość logiczna, która określa stan włączenia przycisku. Gdyfalse, przycisk nie reaguje na dane wejściowe użytkownika.content: zawartość kompozycyjna wewnątrz przycisku, zwykleIcon.
Najważniejsze parametry IconToggleButton to:
checked: wartość logiczna, która określa stan zaznaczenia przycisku.onCheckedChange: funkcja lambda, która jest wykonywana, gdy użytkownik kliknie przycisk, i która podaje nowy stan zaznaczenia.enabled: wartość logiczna, która określa stan włączenia przycisku. Gdyfalse, przycisk nie reaguje na dane wejściowe użytkownika.
Podstawowy przykład: przycisk ikony przełącznika
Przyciski ikon przełączania umożliwiają zaznaczenie lub odznaczenie pojedynczego wyboru, np. dodanie lub usunięcie czegoś z ulubionych. Do tego celu służy IconToggleButton i jego warianty.
Poniższy przykład pokazuje, jak zaimplementować przycisk ikony przełącznika, który zmienia wygląd w zależności od tego, czy jest zaznaczony, czy nie, przez zarządzanie stanem za pomocą IconButton:
@Preview @Composable fun ToggleIconButtonExample() { // isToggled initial value should be read from a view model or persistent storage. var isToggled by rememberSaveable { mutableStateOf(false) } IconButton( onClick = { isToggled = !isToggled } ) { Icon( painter = if (isToggled) painterResource(R.drawable.favorite_filled) else painterResource(R.drawable.favorite), contentDescription = if (isToggled) "Selected icon button" else "Unselected icon button." ) } }
Najważniejsze informacje o kodzie
- Element kompozycyjny
ToggleIconButtonExampledefiniuje przełączany elementIconButton.mutableStateOf(false)tworzy obiektMutableState, który zawiera wartość logiczną, początkowofalse. Dzięki temuisToggledjest zmienną stanu, co oznacza, że Compose ponownie komponuje interfejs, gdy zmienia się jej wartość.rememberSaveabledba o to, aby stanisToggledbył zachowywany podczas zmian konfiguracji, takich jak obrót ekranu.
- Funkcja lambda
onClickelementuIconButtonokreśla zachowanie przycisku po kliknięciu, przełączając stan międzytrueafalse. - Parametr
painterfunkcji kompozycyjnejIconwarunkowo wczytuje inny elementpainterResourcena podstawie stanuisToggled. Zmienia to wygląd ikony.- Jeśli
isToggledtotrue, wczytuje wypełnione serce. - Jeśli
isToggledtofalse, wczytuje element rysowalny z konturem serca.
- Jeśli
contentDescriptionelementuIconrównież aktualizuje się na podstawie stanuisToggled, aby dostarczać odpowiednie informacje o ułatwieniach dostępu.
Wynik
Poniższy obraz przedstawia przycisk przełącznika z poprzedniego fragmentu kodu w stanie wybranym:
Przykład zaawansowany: powtarzane działania po naciśnięciu
W tej sekcji pokazujemy, jak tworzyć przyciski ikon, które stale wywołują działanie, gdy użytkownik je naciśnie i przytrzyma, a nie tylko raz po kliknięciu.
@Composable fun MomentaryIconButton( unselectedImage: Int, selectedImage: Int, contentDescription: String, modifier: Modifier = Modifier, stepDelay: Long = 100L, // Minimum value is 1L milliseconds. onClick: () -> Unit ) { val interactionSource = remember { MutableInteractionSource() } val isPressed by interactionSource.collectIsPressedAsState() val pressedListener by rememberUpdatedState(onClick) LaunchedEffect(isPressed) { while (isPressed) { delay(stepDelay.coerceIn(1L, Long.MAX_VALUE)) pressedListener() } } IconButton( modifier = modifier, onClick = onClick, interactionSource = interactionSource ) { Icon( painter = if (isPressed) painterResource(id = selectedImage) else painterResource(id = unselectedImage), contentDescription = contentDescription, ) } }
Najważniejsze informacje o kodzie
MomentaryIconButtonprzyjmujeunselectedImage: Int, czyli identyfikator zasobu obiektu rysowalnego dla ikony, gdy przycisk nie jest naciśnięty, orazselectedImage: Int, czyli identyfikator zasobu obiektu rysowalnego dla ikony, gdy przycisk jest naciśnięty.- Używa
interactionSourcedo śledzenia interakcji „naciśnięcia” przez użytkownika. isPressedma wartość true, gdy przycisk jest aktywnie naciskany, a w przeciwnym razie ma wartość false. GdyisPressedma wartośćtrue,LaunchedEffectwchodzi w pętlę.- W tej pętli używa
delay(zstepDelay) do tworzenia przerw między działaniami wyzwalającymi.coerceInzapewnia, że opóźnienie wynosi co najmniej 1 ms, aby zapobiec nieskończonym pętlom. - Funkcja
pressedListenerjest wywoływana po każdym opóźnieniu w pętli. Spowoduje to powtórzenie działania.
- W tej pętli używa
pressedListenerużywarememberUpdatedState, aby mieć pewność, że lambdaonClick(działanie do wykonania) jest zawsze aktualna i pochodzi z najnowszej kompozycji.- Obraz wyświetlany przez
Iconzmienia się w zależności od tego, czy przycisk jest aktualnie naciśnięty.- Jeśli
isPressedma wartość Prawda, wyświetla sięselectedImage. - W przeciwnym razie wyświetli się
unselectedImage.
- Jeśli
Następnie użyj tego MomentaryIconButton w przykładzie. Ten fragment kodu pokazuje 2 przyciski ikon sterujące licznikiem:
@Preview() @Composable fun MomentaryIconButtonExample() { var pressedCount by remember { mutableIntStateOf(0) } Row( modifier = Modifier.fillMaxWidth(), verticalAlignment = Alignment.CenterVertically ) { MomentaryIconButton( unselectedImage = R.drawable.fast_rewind, selectedImage = R.drawable.fast_rewind_filled, stepDelay = 100L, onClick = { pressedCount -= 1 }, contentDescription = "Decrease count button" ) Spacer(modifier = Modifier) Text("advanced by $pressedCount frames") Spacer(modifier = Modifier) MomentaryIconButton( unselectedImage = R.drawable.fast_forward, selectedImage = R.drawable.fast_forward_filled, contentDescription = "Increase count button", stepDelay = 100L, onClick = { pressedCount += 1 } ) } }
Najważniejsze informacje o kodzie
- Funkcja kompozycyjna
MomentaryIconButtonExamplewyświetla elementRowzawierający 2 instancjeMomentaryIconButtoni funkcję kompozycyjnąText, aby utworzyć interfejs do zwiększania i zmniejszania licznika. - Utrzymuje zmienną stanu zmiennego
pressedCountza pomocąrememberimutableIntStateOf, zainicjowaną na 0. Gdy wartośćpressedCountsię zmienia, wszystkie elementy kompozycyjne, które ją obserwują (np. element kompozycyjnyText), są ponownie komponowane, aby odzwierciedlić nową wartość. - Pierwszy element
MomentaryIconButtonzmniejsza wartośćpressedCountpo kliknięciu lub przytrzymaniu. - Drugi przycisk
MomentaryIconButtonzwiększapressedCountpo kliknięciu lub przytrzymaniu. - Oba przyciski mają
stepDelayo wartości 100 milisekund, co oznacza, że działanieonClickpowtarza się co 100 ms, gdy przycisk jest przytrzymywany.
Wynik
Poniższy film przedstawia interfejs z przyciskami ikon i licznikiem:
Aktualizacja M3 Expressive
W aktualizacji M3 Expressive przyciski ikon obsługują dodatkowe opcje rozmiaru, narożników i szerokości oraz mogą zmieniać kształt po naciśnięciu lub wybraniu. Gdy przyciski z ikonami są umieszczone w standardowych grupach przycisków, po naciśnięciu wchodzą też w interakcję z sąsiednimi przyciskami.
Animowany kształt
Przyciski ikon mogą zmieniać kształt po naciśnięciu, a przyciski ikon przełączania mogą zmieniać kształt w zależności od stanu zaznaczenia. Aby włączyć animację kształtu, przekaż IconButtonDefaults.shapes() lub IconButtonDefaults.toggleableShapes() do parametru shapes funkcji IconButton lub IconToggleButton.
Przyciski ikon
Poniższy fragment kodu pokazuje, jak wdrożyć przycisk z ikoną, który po naciśnięciu animuje swój kształt:
@Composable fun IconButtonWithAnimatedShapeSample() { IconButton( onClick = { /* doSomething() */ }, shapes = IconButtonDefaults.shapes(), ) { Icon(painter = rememberVectorPainter(AppIcons.LockFilled), contentDescription = "Localized description") } }
Przyciski przełączania ikon
Poniższy fragment kodu pokazuje, jak wdrożyć przycisk ikony przełącznika, który animuje swój kształt na podstawie stanu zaznaczenia:
@Composable fun IconToggleButtonWithAnimatedShapeSample() { var checked by remember { mutableStateOf(false) } IconToggleButton( checked = checked, onCheckedChange = { checked = it }, shapes = IconButtonDefaults.toggleableShapes(), ) { if (checked) { Icon(painter = rememberVectorPainter(AppIcons.LockFilled), contentDescription = "Localized description") } else { Icon(painter = rememberVectorPainter(AppIcons.Lock), contentDescription = "Localized description") } } }
Warianty rozmiaru, szerokości i kształtu
Przyciski ikon są dostępne w kształtach okrągłych i kwadratowych, w 5 rozmiarach i 3 szerokościach.
Więcej informacji o aktualizacjach Material 3 Expressive dotyczących przycisków ikon znajdziesz w wytycznych dotyczących przycisków ikon w Material Design 3.
Dostępnych jest 5 rozmiarów przycisków ikon: bardzo mały, mały, średni, duży i bardzo duży. Każdy rozmiar obsługuje 3 opcje szerokości: jednolitą (domyślną), wąską i szeroką.
Przyciski ikon są dostępne w wariantach z zaokrąglonymi lub kwadratowymi rogami, a przyciski ikon przełączania zmieniają kształt po naciśnięciu lub wybraniu.
Wskazówki dotyczące wyboru wariantów narożników znajdziesz w wytycznych dotyczących przycisków ikon w Material Design 3.