読み込みインジケーター

読み込みインジケーターは、短い待機時間(通常は 5 秒以内に完了するオペレーション)の進行状況を示します。読み込みインジケーターには、次の 2 つの構成があります。

  1. デフォルト: 境界のないモーフィング シェイプ。
  2. コンテナ内: 円形のコンテナ内でモーフィングする形状。
読み込みインジケーターのデフォルト構成とコンテナ構成
図 1. デフォルトの読み込みインジケーターとコンテナ内の読み込みインジケーター。

インジケーターは、無期限に、または進行状況の値に応じて、ポリゴン形状間で継続的に変化します。

読み込みインジケーターの使用

  • ほとんどの不確定な円形進行状況インジケーターの代わりとして推奨されます。
  • 常に進行中のプロセスを反映し、単なる装飾として使用しない。
  • 進行状況を測定できない場合や、アクティビティにかかる時間を示す必要がない場合に使用します。
  • スワイプで更新する操作に使用できます。
  • 形状が変化するモーションで注目を集めます。

例

読み込みインジケーターを実装する

読み込みインジケーターは、アニメーションを使用して注意を引き、認識されるレイテンシを軽減し、アクティビティが進行中であることを示します。次のスニペットは、デフォルトの不確定な 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),
        )
    }
}