Индикаторы загрузки показывают прогресс для короткого времени ожидания – обычно для операций, которые завершаются менее чем за пять секунд. Существует две конфигурации индикаторов загрузки:
- По умолчанию. Меняющиеся фигуры без контейнера.
- В контейнере. Меняющиеся фигуры в круглом контейнере.
Индикатор непрерывно меняет форму между многоугольниками либо бесконечно, либо в ответ на значение прогресса.
Использование индикаторов загрузки
- Рекомендуется в качестве замены для большинства неопределенных круговых индикаторов выполнения.
- Всегда отражают текущий процесс и никогда не являются чисто декоративными.
- Используйте их, когда прогресс не поддается измерению или когда нет необходимости указывать, сколько времени занимает действие.
- Может использоваться для взаимодействия с помощью жеста "Потянуть, чтобы обновить".
- Привлекайте внимание с помощью анимации, меняющей форму.
Примеры
Добавьте индикатор загрузки
Индикаторы загрузки используют анимацию, чтобы привлечь внимание, уменьшить воспринимаемую задержку и указать, что действие выполняется. В следующем фрагменте кода показан стандартный неопределенный элемент LoadingIndicator:
@Composable fun LoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { LoadingIndicator() } }
Как реализовать индикатор загрузки в контейнере
Используйте ContainedLoadingIndicator, чтобы отображать меняющиеся фигуры внутри круглого контейнера, который обеспечивает дополнительный контраст с основным контентом. В следующем фрагменте кода показано, как реализовать индикатор загрузки в контейнере:
@Composable fun ContainedLoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { ContainedLoadingIndicator() } }
Реализуйте индикатор загрузки
Передайте лямбда-функцию progress, возвращающую Float из 0.0 в 1.0, чтобы преобразовать 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), ) } }