載入指標會顯示短暫等待時間的進度,通常是五秒內完成的作業。載入指標有兩種設定:
- 預設:不限於容器內的變形。
- 內含:在圓形容器內變形。
指標會持續在多邊形形狀之間變換,可能是無限期變換,也可能是根據進度值變換。
使用載入指標
- 建議用來取代大多數不確定圓形進度指標。
- 一律反映進行中的程序,絕非純粹裝飾。
- 當進度無法測量,或不需要指出活動所需時間時,請使用這類指標。
- 可用於下拉更新互動。
- 透過形狀變換動作吸引注意力。
範例
實作載入指標
載入指標會使用動畫吸引使用者注意、降低感知延遲,並表示活動正在進行中。下列程式碼片段會算繪預設的不確定 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), ) } }