Indicadores de carregamento

Os indicadores de carregamento mostram o progresso de um tempo de espera curto, normalmente operações que são concluídas em menos de cinco segundos. Há duas configurações de indicadores de carregamento:

  1. Padrão: formas de transformação não contidas.
  2. Contido: formas que se transformam dentro de um contêiner circular.
Configurações padrão e contidas de indicadores de carregamento
Figura 1. Indicadores de carregamento padrão e contidos.

O indicador se transforma continuamente entre as formas poligonais, de forma indefinida ou em resposta a um valor de progresso.

Como usar indicadores de carregamento

  • Recomendado como substituto para a maioria dos indicadores de progresso circular indeterminados.
  • Sempre refletem um processo em andamento e nunca são puramente decorativos.
  • Use-os quando o progresso não for mensurável ou quando não for necessário indicar quanto tempo uma atividade leva.
  • Pode ser usado para interações de arrastar para baixo para atualizar.
  • Chame a atenção com movimentos de transformação de formas.

Exemplos

Implementar um indicador de carregamento

Os indicadores de carregamento usam animação para chamar a atenção, reduzir a latência percebida e indicar que uma atividade está em andamento. O snippet abaixo renderiza um LoadingIndicator indeterminado padrão:

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

Implementar um indicador de carregamento contido

Use ContainedLoadingIndicator para renderizar formas de transformação dentro de um contêiner circular que oferece contraste extra sobre o conteúdo do corpo. O snippet a seguir implementa um indicador de carregamento contido:

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

Implementar um indicador de carregamento determinado

Transmita um lambda progress que retorna um Float de 0.0 para 1.0 para transformar LoadingIndicator de forma determinada conforme uma operação avança. O snippet abaixo impulsiona o progresso do indicador de carregamento com um Slider e 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),
        )
    }
}