LoadingIndicator
Виджет индикатора загрузки с поддержкой режимов кольца, полосы, пульсации и точек.
Обзор
LoadingIndicator предоставляет динамическую визуальную индикацию выполнения фоновых операций и асинхронных задач.
Поддерживаемые стили и режимы:
- Разнообразные режимы анимации: RING (кольцо), BAR (полоса), PULSE (пульсация), DOTS (точки).
- Точная настройка числа дуг, скорости, фазы, толщины и геометрических размеров.
- Автоматическая интеграция в цикл обновления кадров при активном состоянии.
Настройка и отображение индикатора загрузки
LoadingIndicator indicator = new LoadingIndicator();
indicator.mode(LoadingIndicator.Mode.SPINNER).start();
Связанные ссылки
- ProgressBar: Линейный индикатор прогресса, отображающий детерминированное или неопределенное состояние выполнения.
- Spinner: Вращающийся индикатор прогресса (спиннер) для отображения фоновых операций.
API
LoadingIndicator()
Создает LoadingIndicator с режимом SPINNER и стилями по умолчанию.
LoadingIndicator::accentColor()
Возвращает основной акцентный цвет индикатора.
Возвращает MutableColor: Экземпляр изменяемого цвета..
LoadingIndicator::activeDots()
Возвращает количество подсвеченных активных точек.
Возвращает int: Количество точек..
LoadingIndicator::activeDots(int)
Устанавливает количество подсвеченных активных точек.
| Параметр | Тип | Описание |
|---|---|---|
activeDots |
int |
Количество подсвеченных активных точек. |
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..
LoadingIndicator::angle()
Возвращает угол охвата дуги в радианах.
Возвращает float: Угол фазы вращения в радианах..
LoadingIndicator::angle(float)
Устанавливает угол охвата дуги в радианах.
| Параметр | Тип | Описание |
|---|---|---|
radians |
float |
Угол фазы вращения в радианах. |
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..
LoadingIndicator::arcs()
Возвращает количество дуг для многодуговых стилей.
Возвращает int: Количество сегментов или дуг..
LoadingIndicator::arcs(int)
Устанавливает количество дуг для многодуговых стилей.
| Параметр | Тип | Описание |
|---|---|---|
arcs |
int |
Количество сегментов или дуг. |
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..
LoadingIndicator::dots()
Возвращает общее количество точек для точечных стилей.
Возвращает int: Количество точек..
LoadingIndicator::dots(int)
Устанавливает общее количество точек для точечных стилей.
| Параметр | Тип | Описание |
|---|---|---|
dots |
int |
Общее количество точек. |
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..
LoadingIndicator::indicatorSize(float)
Устанавливает одновременно одинаковую предпочитаемую ширину и высоту в пикселях.
| Параметр | Тип | Описание |
|---|---|---|
size |
float |
Размер стороны или диаметр индикатора. |
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..
LoadingIndicator::mode()
Возвращает активный режим отображения (SPINNER, BAR, PULSE, DOTS и др.).
Возвращает Mode: Режим отображения индикатора загрузки..
LoadingIndicator::mode(Mode)
Устанавливает режим отображения индикатора загрузки.
| Параметр | Тип | Описание |
|---|---|---|
mode |
Mode |
Режим отображения индикатора загрузки. |
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..
LoadingIndicator::phase()
Возвращает текущую нормализованную фазу анимации от 0.0 до 1.0.
Возвращает float: Угол фазы вращения в радианах..
LoadingIndicator::phase(float)
Устанавливает значение фазы анимации вручную.
| Параметр | Тип | Описание |
|---|---|---|
phase |
float |
Угол фазы вращения в радианах. |
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..
LoadingIndicator::preferredHeight()
Возвращает предпочитаемую высоту индикатора.
Возвращает float: Числовое значение с плавающей точкой..
LoadingIndicator::preferredHeight(float)
Устанавливает предпочитаемую высоту индикатора в пикселях.
| Параметр | Тип | Описание |
|---|---|---|
preferredHeight |
float |
Предпочитаемая высота. |
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..
LoadingIndicator::preferredSize(float, float)
Устанавливает независимые предпочитаемые ширину и высоту.
| Параметр | Тип | Описание |
|---|---|---|
width |
float |
Ширина в пикселях. |
height |
float |
Высота в пикселях. |
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..
LoadingIndicator::preferredWidth()
Возвращает предпочитаемую ширину индикатора.
Возвращает float: Числовое значение с плавающей точкой..
LoadingIndicator::preferredWidth(float)
Устанавливает предпочитаемую ширину индикатора в пикселях.
| Параметр | Тип | Описание |
|---|---|---|
preferredWidth |
float |
Предпочитаемая ширина. |
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..
LoadingIndicator::radius()
Возвращает явный радиус индикатора в пикселях или 0 при автоматическом расчете.
Возвращает float: Числовое значение с плавающей точкой..
LoadingIndicator::radius(float)
Устанавливает явный радиус индикатора в пикселях.
| Параметр | Тип | Описание |
|---|---|---|
radius |
float |
Радиус окружности или дуги в пикселях. |
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..
LoadingIndicator::running()
Возвращает true, если анимация запущена в данный момент.
Возвращает boolean: True, если анимация запущена..
LoadingIndicator::running(boolean)
Запускает или останавливает анимацию индикатора.
| Параметр | Тип | Описание |
|---|---|---|
running |
boolean |
Активна ли анимация в текущий момент. |
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..
LoadingIndicator::secondaryColor()
Возвращает вторичный цвет подсветки.
Возвращает MutableColor: Экземпляр изменяемого цвета..
LoadingIndicator::segments()
Возвращает количество сегментов для сегментированных стилей.
Возвращает int: Количество сегментов или дуг..
LoadingIndicator::segments(int)
Устанавливает количество сегментов для сегментированных стилей.
| Параметр | Тип | Описание |
|---|---|---|
segments |
int |
Количество сегментов или дуг. |
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..
LoadingIndicator::speed()
Возвращает множитель скорости анимации.
Возвращает float: Множитель скорости анимации..
LoadingIndicator::speed(float)
Устанавливает множитель скорости анимации.
| Параметр | Тип | Описание |
|---|---|---|
speed |
float |
Множитель скорости анимации. |
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..
LoadingIndicator::spinnerStyle()
Возвращает активный пресет стиля спиннера.
LoadingIndicator::spinnerStyle(Style)
Устанавливает пресет стиля спиннера.
| Параметр | Тип | Описание |
|---|---|---|
spinnerStyle |
Style |
Визуальный стиль анимации. |
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..
LoadingIndicator::start()
Запускает анимацию индикатора.
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..
LoadingIndicator::stop()
Останавливает анимацию индикатора.
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..
LoadingIndicator::thickness()
Возвращает толщину линии обводки в пикселях интерфейса.
Возвращает float: Числовое значение с плавающей точкой..
LoadingIndicator::thickness(float)
Устанавливает толщину линии обводки в пикселях интерфейса.
| Параметр | Тип | Описание |
|---|---|---|
thickness |
float |
Толщина линии в пикселях. |
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..
LoadingIndicator::trackColor()
Возвращает фоновый цвет дорожки индикатора.
Возвращает MutableColor: Экземпляр изменяемого цвета..
LoadingIndicator::useDefaultPreferredSize()
Сбрасывает размеры к значениям по умолчанию для текущего режима.
Возвращает LoadingIndicator: Текущий экземпляр виджета для цепочки вызовов..