載入指標

載入指標會顯示短暫等待時間的進度,通常是五秒內完成的作業。載入指標有兩種設定:

  1. 預設:不限於容器內的變形。
  2. 內含:在圓形容器內變形。
載入指標的預設和內含設定
圖 1. 預設和內含的載入指標。

指標會持續在多邊形形狀之間變換,可能是無限期變換,也可能是根據進度值變換。

使用載入指標

  • 建議用來取代大多數不確定圓形進度指標。
  • 一律反映進行中的程序,絕非純粹裝飾。
  • 當進度無法測量,或不需要指出活動所需時間時,請使用這類指標。
  • 可用於下拉更新互動。
  • 透過形狀變換動作吸引注意力。

範例

實作載入指標

載入指標會使用動畫吸引使用者注意、降低感知延遲,並表示活動正在進行中。下列程式碼片段會算繪預設的不確定 LoadingIndicator:

@Composable
fun LoadingIndicatorSample() {
    Column(horizontalAlignment = Alignment.CenterHorizontally) { LoadingIndicator() }
}

實作內含載入指標

使用 ContainedLoadingIndicator 在圓形容器中算繪變形形狀,與內文內容形成額外對比。下列程式碼片段會實作內含的載入指標:

@Composable
fun ContainedLoadingIndicatorSample() {
    Column(horizontalAlignment = Alignment.CenterHorizontally) { ContainedLoadingIndicator() }
}

導入確定型載入指標

將傳回 Float 的 progress lambda 從 0.0 傳遞至 1.0,以便在作業進行時,明確變形 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),
        )
    }
}