アイコンボタンは、ユーザーが実行できるアクションを表示します。アイコンボタンには、明確な意味を持つアイコンを使用する必要があります。通常、アイコンボタンは一般的または頻繁に使用されるアクションを表します。
アイコンボタンには次の 2 種類があります。
- デフォルト: これらのボタンは、メニューや検索などの他の要素を開くことができます。
- 切り替え: これらのボタンは、「お気に入り」や「ブックマーク」など、オンとオフを切り替えることができるバイナリ アクションを表します。
API サーフェス
標準のアイコンボタンを実装するには IconButton コンポーザブルを使用し、選択状態と未選択状態を切り替えるボタンには IconToggleButton を使用します。塗りつぶし、塗りつぶしトーン、アウトラインなどのさまざまなビジュアル スタイルを作成するには、FilledIconButton、FilledTonalIconButton、OutlinedIconButton、または切り替え可能な対応する FilledIconToggleButton、FilledTonalIconToggleButton、OutlinedIconToggleButton を使用します。
IconButton の主なパラメータは次のとおりです。
onClick: ユーザーがアイコンボタンをタップしたときに実行されるラムダ関数。enabled: ボタンの有効状態を制御するブール値。falseの場合、ボタンはユーザー入力に応答しません。content: ボタン内のコンポーザブル コンテンツ。通常はIcon。
IconToggleButton の主なパラメータは次のとおりです。
checked: ボタンの選択状態を制御するブール値。onCheckedChange: ユーザーがボタンをタップしたときに実行されるラムダ関数。新しいチェック状態を提供します。enabled: ボタンの有効状態を制御するブール値。falseの場合、ボタンはユーザー入力に応答しません。
基本的な例: 切り替えアイコンボタン
切り替えアイコンボタンを使用すると、お気に入りの追加や削除など、単一の選択肢を選択または選択解除できます。IconToggleButton とそのバリアントは、この目的のために設計されています。
次の例は、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." ) } }
コードに関する主なポイント
ToggleIconButtonExampleコンポーザブルは、切り替え可能なIconButtonを定義します。mutableStateOf(false)は、ブール値を保持するMutableStateオブジェクトを作成します。初期値はfalseです。これにより、isToggledが状態ホルダーになり、値が変更されるたびに Compose が UI を再コンポーズします。rememberSaveableは、画面の回転などの構成変更後もisToggledの状態が維持されるようにします。
IconButtonのonClickラムダは、クリックされたときのボタンの動作を定義し、trueとfalseの間で状態を切り替えます。Iconコンポーザブルのpainterパラメータは、isToggled状態に基づいて異なるpainterResourceを条件付きで読み込みます。これにより、アイコンの外観が変更されます。isToggledがtrueの場合は、塗りつぶされたハートのドローアブルを読み込みます。isToggledがfalseの場合、輪郭線のみのハートのドローアブルを読み込みます。
IconのcontentDescriptionも、isToggledの状態に基づいて更新され、適切なユーザー補助情報を提供します。
結果
次の画像は、上記のスニペットの切り替えアイコンボタンが選択された状態を示しています。
高度な例: 押したときに繰り返しアクションを実行する
このセクションでは、クリックごとに 1 回だけアクションをトリガーするのではなく、ユーザーが長押ししている間、アクションを継続的にトリガーするアイコンボタンを作成する方法について説明します。
@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, ) } }
コードに関する主なポイント
MomentaryIconButtonは、unselectedImage: Int(ボタンが押されていないときのアイコンのドローアブル リソース ID)とselectedImage: Int(ボタンが押されたときのアイコンのドローアブル リソース ID)を受け取ります。interactionSourceを使用して、ユーザーからの「押す」操作を具体的に追跡します。isPressedは、ボタンが実際に押されている場合は true、それ以外の場合は false です。isPressedがtrueの場合、LaunchedEffectはループに入ります。- このループ内では、
delay(stepDelayを使用)を使用して、アクションのトリガー間に一時停止を作成します。coerceInは、無限ループを防ぐために遅延が 1 ミリ秒以上になるようにします。 pressedListenerは、ループ内の各遅延の後に呼び出されます。これにより、アクションが繰り返されます。
- このループ内では、
pressedListenerはrememberUpdatedStateを使用して、onClickラムダ(実行するアクション)が常に最新のコンポジションから最新の状態になるようにします。Iconは、ボタンが現在押されているかどうかに基づいて、表示される画像を変更します。isPressedが true の場合、selectedImageが表示されます。- それ以外の場合は、
unselectedImageが表示されます。
次に、この MomentaryIconButton を例で使用します。次のスニペットは、カウンタを制御する 2 つのアイコンボタンを示しています。
@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 } ) } }
コードに関する主なポイント
MomentaryIconButtonExampleコンポーザブルは、2 つのMomentaryIconButtonインスタンスを含むRowと、カウンタを増減する UI を構築するTextコンポーザブルを表示します。rememberとmutableIntStateOfを使用して、0 に初期化されたpressedCount可変状態変数を保持します。pressedCountが変更されると、それを監視しているコンポーザブル(Textコンポーザブルなど)が再コンポーズされ、新しい値が反映されます。- 最初の
MomentaryIconButtonは、クリックまたは長押しするとpressedCountを減らします。 - 2 つ目の
MomentaryIconButtonは、クリックまたは長押しするとpressedCountを増やします。 - どちらのボタンも
stepDelayが 100 ミリ秒に設定されているため、ボタンを長押ししている間、onClickアクションが 100 ミリ秒ごとに繰り返されます。
結果
次の動画は、アイコンボタンとカウンタを含む UI を示しています。
M3 表現豊かなアップデート
M3 Expressive のアップデートにより、アイコンボタンはサイズ、角、幅の追加オプションをサポートし、押されたときや選択されたときに形状を変更できるようになりました。標準のボタン グループに配置されたアイコンボタンは、押されたときに隣接するボタンとも連動します。
アニメーション シェイプ
アイコンボタンは、押されたときに形状をアニメーション化できます。切り替えアイコンボタンは、チェック状態に基づいて形状をアニメーション化できます。シェイプ アニメーションを有効にするには、IconButtonDefaults.shapes() または IconButtonDefaults.toggleableShapes() を IconButton または IconToggleButton の shapes パラメータに渡します。
アイコンボタン
次のスニペットは、押されたときに形状がアニメーション化されるアイコンボタンを実装する方法を示しています。
@Composable fun IconButtonWithAnimatedShapeSample() { IconButton( onClick = { /* doSomething() */ }, shapes = IconButtonDefaults.shapes(), ) { Icon(painter = rememberVectorPainter(AppIcons.LockFilled), contentDescription = "Localized description") } }
切り替えアイコンボタン
次のスニペットは、チェック状態に基づいて形状をアニメーション化する切り替えアイコンボタンを実装する方法を示しています。
@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") } } }
サイズ、幅、形状のバリエーション
アイコンボタンは、円形と正方形、5 つのサイズ、3 つの幅で使用できます。
アイコンボタンの M3 Expressive の更新の詳細については、マテリアル デザイン 3 のアイコンボタンのガイドラインをご覧ください。
アイコンボタンのサイズ バリエーションには、特小、小、中、大、特大の 5 つがあります。各サイズは、均一(デフォルト)、狭い、広いの 3 つの幅オプションをサポートしています。
アイコンボタンには、角が丸いものと角が四角いものがあり、切り替えアイコンボタンは、押されたときや選択されたときに形状が変化します。
角のバリエーションを選択する際のガイダンスについては、マテリアル デザイン 3 のアイコンボタンのガイドラインをご覧ください。