Индикаторы хода выполнения визуально отображают состояние операции. Они используют движение, чтобы обратить внимание пользователя на то, насколько близок к завершению процесс, например загрузка или обработка данных. Они также могут обозначать, что обработка происходит, безотносительно того, насколько близка к ее завершению.
Рассмотрим эти три варианта использования, в которых вы можете использовать индикатор прогресса:
- Загрузка контента : при получении контента из сети, например при загрузке изображения или данных для профиля пользователя.
- Загрузка файла : сообщите пользователю, сколько времени может занять загрузка.
- Длительная обработка . Пока приложение обрабатывает большой объем данных, сообщите пользователю, какая часть из них завершена.
В Material Design существует два типа индикатора прогресса:
- Определенный : точно показывает, какой прогресс был достигнут.
- Неопределенный : Анимируется постоянно, независимо от прогресса.
Аналогично, индикатор прогресса может принимать одну из двух следующих форм:
- Линейный : горизонтальная полоса, заполняющаяся слева направо.
- Круглый : круг, длина штриха которого увеличивается до тех пор, пока не охватит всю окружность круга.
Совместимость версий
Для этой реализации требуется, чтобы в minSDK вашего проекта был установлен уровень API 21 или выше.
Зависимости
Создание определенных индикаторов
Определенный показатель точно отражает, насколько завершено действие. Используйте составные элементы LinearProgressIndicator
или CircularProgressIndicator
и передайте значение для параметра progress
.
Следующий фрагмент представляет собой относительно подробный пример. Когда пользователь нажимает кнопку, приложение отображает индикатор прогресса и запускает сопрограмму, которая постепенно увеличивает значение progress
. Это приводит к тому, что индикатор прогресса поочередно перемещается вверх.
Результаты
Когда загрузка частично завершена, линейный индикатор в предыдущем примере выглядит следующим образом:
Аналогично, круглый индикатор выглядит следующим образом:
Создание неопределенных индикаторов
Неопределенный показатель не отражает того, насколько близка к завершению операция. Скорее, он использует движение, чтобы указать пользователю, что обработка продолжается, хотя и без указания степени завершения.
Чтобы создать неопределенный индикатор прогресса, используйте составной LinearProgressIndicator
или CircularProgressIndicator
, но не передавайте значение для progress
. В следующем примере показано, как можно переключить неопределенный индикатор нажатием кнопки.
Результаты
Ниже приведен пример такой реализации, когда индикатор активен:
Ниже приведен пример той же реализации, но с LinearProgressIndicator
вместо CircularProgressIndicator
.
Ключевые моменты
Хотя существует несколько составных элементов, которые вы можете использовать для создания индикаторов прогресса в соответствии с Material Design, их параметры не сильно различаются. Среди ключевых параметров, на которые следует обратить внимание, можно выделить следующие:
-
progress
: текущий прогресс, отображаемый индикатором. ПередайтеFloat
между0.0
и1.0
. -
color
: цвет индикатора, то есть части компонента, которая отражает прогресс и которая полностью охватывает компонент, когда прогресс завершен. -
trackColor
: цвет трека, над которым отображается индикатор.
Коллекции, содержащие это руководство
Это руководство является частью тщательно подобранной коллекции быстрых руководств, охватывающих более широкие цели разработки Android:
![](https://developer.android.com/static/images/quick-guides/collection-illustration.png?hl=ru)
Отображать интерактивные компоненты
![](https://developer.android.com/static/images/quick-guides/collection-illustration.png?hl=ru)