로딩 표시기는 짧은 대기 시간(일반적으로 5초 이내에 완료되는 작업)의 진행 상황을 표시합니다. 로딩 표시기에는 두 가지 구성이 있습니다.
- 기본값: 포함되지 않은 변형 도형
- 포함: 원형 컨테이너 내에서 도형이 변형됩니다.
표시기는 무한정 또는 진행률 값에 따라 다각형 모양 간에 지속적으로 변형됩니다.
로드 표시기 사용
- 대부분의 불확정 원형 진행률 표시기를 대체하는 데 권장됩니다.
- 항상 진행 중인 프로세스를 반영하며 순수하게 장식용으로만 사용되지 않습니다.
- 진행 상황을 측정할 수 없거나 활동에 걸리는 시간을 표시할 필요가 없는 경우에 사용합니다.
- 당겨서 새로고침 상호작용에 사용할 수 있습니다.
- 모양 변형 모션을 통해 관심을 사로잡습니다.
예
로드 표시기 구현
로딩 표시기는 애니메이션을 사용하여 주의를 끌고, 인지된 지연 시간을 완화하며, 활동이 진행 중임을 나타냅니다. 다음 스니펫은 기본 불확정 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), ) } }