Индикаторы загрузки

Индикаторы загрузки показывают прогресс для короткого времени ожидания – обычно для операций, которые завершаются менее чем за пять секунд. Существует две конфигурации индикаторов загрузки:

  1. По умолчанию. Меняющиеся фигуры без контейнера.
  2. В контейнере. Меняющиеся фигуры в круглом контейнере.
Конфигурации индикаторов загрузки по умолчанию и в контейнере
Рисунок 1. Индикаторы загрузки по умолчанию и в контейнере.

Индикатор непрерывно меняет форму между многоугольниками либо бесконечно, либо в ответ на значение прогресса.

Использование индикаторов загрузки

  • Рекомендуется в качестве замены для большинства неопределенных круговых индикаторов выполнения.
  • Всегда отражают текущий процесс и никогда не являются чисто декоративными.
  • Используйте их, когда прогресс не поддается измерению или когда нет необходимости указывать, сколько времени занимает действие.
  • Может использоваться для взаимодействия с помощью жеста "Потянуть, чтобы обновить".
  • Привлекайте внимание с помощью анимации, меняющей форму.

Примеры

Добавьте индикатор загрузки

Индикаторы загрузки используют анимацию, чтобы привлечь внимание, уменьшить воспринимаемую задержку и указать, что действие выполняется. В следующем фрагменте кода показан стандартный неопределенный элемент 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),
        )
    }
}