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:
- Padrão: formas de transformação não contidas.
- Contido: formas que se transformam dentro de um contêiner circular.
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), ) } }