読み込みインジケーターは、短い待機時間(通常は 5 秒以内に完了するオペレーション)の進行状況を示します。読み込みインジケーターには、次の 2 つの構成があります。
- デフォルト: 境界のないモーフィング シェイプ。
- コンテナ内: 円形のコンテナ内でモーフィングする形状。
インジケーターは、無期限に、または進行状況の値に応じて、ポリゴン形状間で継続的に変化します。
読み込みインジケーターの使用
- ほとんどの不確定な円形進行状況インジケーターの代わりとして推奨されます。
- 常に進行中のプロセスを反映し、単なる装飾として使用しない。
- 進行状況を測定できない場合や、アクティビティにかかる時間を示す必要がない場合に使用します。
- スワイプで更新する操作に使用できます。
- 形状が変化するモーションで注目を集めます。
例
読み込みインジケーターを実装する
読み込みインジケーターは、アニメーションを使用して注意を引き、認識されるレイテンシを軽減し、アクティビティが進行中であることを示します。次のスニペットは、デフォルトの不確定な LoadingIndicator をレンダリングします。
@Composable fun LoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { LoadingIndicator() } }
コンテナ化された読み込みインジケーターを実装する
ContainedLoadingIndicator を使用して、本文コンテンツとのコントラストを高める円形コンテナ内にモーフィング シェイプをレンダリングします。次のスニペットは、コンテナ化された読み込みインジケーターを実装しています。
@Composable fun ContainedLoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { ContainedLoadingIndicator() } }
確定的な読み込みインジケーターを実装する
0.0 から 1.0 までの Float を返す progress ラムダを に渡して、オペレーションの進行に合わせて
LoadingIndicator を決定的にモーフィングします。次のスニペットは、Slider と rememberSliderState を使用して読み込みインジケーターの進行状況を制御します。
@Composable fun DeterminateLoadingIndicatorSample() { val sliderState = rememberSliderState() val animatedProgress by animateFloatAsState( targetValue = sliderState.value, animationSpec = spring( dampingRatio = Spring.DampingRatioNoBouncy, stiffness = Spring.StiffnessVeryLow, visibilityThreshold = 1 / 1000f, ), ) Column(horizontalAlignment = Alignment.CenterHorizontally) { LoadingIndicator(progress = { animatedProgress }) Spacer(Modifier.requiredHeight(30.dp)) Text("Set loading progress:") Slider( state = sliderState, onValueChange = { sliderState.value = it }, modifier = Modifier.width(300.dp), ) } }