Свайп для обновления в Android
Свайп для обновления (Swipe to refresh) позволяет пользователю вручную обновлять контент экрана с помощью специального жеста или действия.
Использование
Свайп для обновления — это жест смахивания, доступный в начале списков, списков-сеток (grid lists) и коллекций карточек, то есть в тех местах, где отображается самый свежий контент (с индексом 0).
Этот жест лучше всего подходит для динамического контента, который часто обновляется, при этом новые данные появляются в одном и том же месте. В таком случае высока вероятность, что пользователь увидит новый контент после выполнения жеста.
Индикатор обновления
Индикатор обновления появляется только при выполнении жеста или действия обновления. При фоновой синхронизации он не отображается.
Эффекты
Изменения могут быть не сразу заметны пользователю, если жест применяется к представлениям, которые после обновления могут значительно меняться. Например, обновление может в произвольном порядке удалять, переупорядочивать, изменять и вставлять элементы — либо затрагивать только элементы за пределами видимой области.
Свайп для обновления не следует использовать в следующих случаях:
- Панели навигации
- Виджеты на главном экране
- Панорамируемый контент

Не рекомендуется

Не рекомендуется

Не рекомендуется
Поведение и размещение
Поведение
Когда индикатор обновления появляется на экране, круговой спиннер постепенно проявляется, вращаясь.
Индикатор обновления остаётся видимым до тех пор, пока процесс обновления не завершится и новый контент не станет видимым, либо пока пользователь не покинет экран с обновляемым контентом.
Рекомендуется
Не рекомендуется
Переходы индикатора обновления
Когда одна поверхность перекрывает поверхность с обновляемым контентом, индикатор обновления перемещается из-за этой поверхности и частично отсекается, пока не станет полностью видимым.
Индикатор обновления увеличивается при смещении в следующих случаях:
- Обновляемый контент находится на большем возвышении, чем все остальные поверхности
- Обновление инициируется действием на панели приложения (app bar) или в дополнительном меню (overflow menu)
Требования к порогу срабатывания
Чтобы жест смахивания для обновления срабатывал осознанно, индикатор обновления должен пройти пороговое значение, прежде чем приложение выполнит обновление. О достижении порога свидетельствуют следующие признаки:
- Кольцевой индикатор становится полностью непрозрачным (непрозрачность 100%)
- Вращение кольцевого индикатора замедляется
- Скорость смещения индикатора обновления снижается
После прохождения порога завершение жеста запускает обновление.
Если после прохождения порога выполнить жест в обратном направлении, обновление будет отменено.
Свайп для обновления в компоновке
Расположение жеста
Как правило, жест обновления доступен в верхней части коллекций контента, но он также может располагаться в нижней части экрана.
Индикатор обновления (горизонтальное положение в состоянии покоя)
В состоянии покоя индикатор обновления центрируется по горизонтали относительно обновляемого контента.

Рекомендуется

Не рекомендуется

Не рекомендуется
Индикатор обновления (вертикальное положение в состоянии покоя)
Индикатор обновления располагается возле верхней части обновляемого контента.
Его вертикальное положение в состоянии покоя можно настроить для более гармоничного макета. Например, индикатор может выравниваться по краю поверхности или по модульной сетке при условии, что он остаётся вблизи верхней части обновляемого контента.

Рекомендуется

Не рекомендуется