Los indicadores de carga muestran el progreso de un tiempo de espera breve, por lo general, operaciones que se completan en menos de cinco segundos. Existen dos configuraciones de indicadores de carga:
- Predeterminado: Formas que cambian de aspecto sin límites
- Contenidas: Formas que se transforman dentro de un contenedor circular.
El indicador cambia continuamente entre sus formas poligonales, ya sea de forma indefinida o en respuesta a un valor de progreso.
Usa indicadores de carga
- Se recomienda como reemplazo de la mayoría de los indicadores de progreso circular indeterminados.
- Siempre reflejan un proceso en curso y nunca son puramente decorativos.
- Úsalos cuando no se pueda medir el progreso o cuando no sea necesario indicar cuánto tiempo lleva una actividad.
- Se puede usar para las interacciones de deslizar hacia abajo para actualizar.
- Capta la atención con movimientos de transformación de formas.
Ejemplos
Implementa un indicador de carga
Los indicadores de carga usan animaciones para llamar la atención, mitigar la latencia percibida y señalar que hay una actividad en curso. En el siguiente fragmento, se renderiza un LoadingIndicator indeterminado predeterminado:
@Composable fun LoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { LoadingIndicator() } }
Implementa un indicador de carga contenido
Usa ContainedLoadingIndicator para renderizar formas cambiantes dentro de un contenedor circular que proporcione contraste adicional sobre el contenido del cuerpo. En el siguiente fragmento, se implementa un indicador de carga contenido:
@Composable fun ContainedLoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { ContainedLoadingIndicator() } }
Implementa un indicador de carga determinado
Pasa una expresión lambda progress que devuelva un Float de 0.0 a 1.0 para transformar
LoadingIndicator de forma determinada a medida que avanza una operación. En el siguiente fragmento, se controla el progreso del indicador de carga con un Slider y un 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), ) } }