로드 표시기

로딩 표시기는 짧은 대기 시간(일반적으로 5초 이내에 완료되는 작업)의 진행 상황을 표시합니다. 로딩 표시기에는 두 가지 구성이 있습니다.

  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),
        )
    }
}