Проведите пальцем для обновления
Проведите пальцем для обновления (Swipe to refresh) — жест, позволяющий пользователю вручную обновлять содержимое экрана с помощью свайпа.
В приложении контент можно обновлять двумя способами:
- Предпочтительный способ — автоматическое обновление с помощью синхронизации (sync), которая поддерживает актуальность содержимого без участия пользователя
- Проведите пальцем для обновления — жест смахивания, доступный в начале списков, сеток и подборок карточек, отсортированных по времени добавления (сначала новые)
Ручное обновление может дополнять синхронизацию. Оно сохраняет текущую позицию прокрутки — как при проверке новых писем в Gmail.
Значок
Индикатор обновления имеет вид кругового индикатора загрузки (спиннера) — значка с изогнутой стрелкой, которая вращается.
Расположение
- Жест «проведите пальцем для обновления» доступен в верхней или нижней части подборок контента
- Индикатор обновления в состоянии покоя располагается по горизонтальному центру относительно обновляемого контента
Порог срабатывания
Прежде чем приложение начнёт обновление, индикатор должен достичь порогового значения. О достижении порога свидетельствуют изменения непрозрачности, скорости вращения и величины смещения кругового индикатора.

Использование
«Проведите пальцем для обновления» — это жест смахивания, доступный в начале списков, сеток и подборок карточек, где первым отображается самый новый контент (с нулевым индексом).
Этот жест лучше всего подходит для динамического контента, который часто обновляется и появляется в одном и том же месте: в таком случае после выполнения жеста пользователь с высокой вероятностью увидит новый контент.
Индикатор обновления
Индикатор обновления появляется только при жесте или действии обновления. Во время фоновой синхронизации он не отображается.
Видимые изменения
Если после обновления представление сильно меняется, пользователю может быть неочевидно, что именно изменилось. Например, обновление может в произвольном порядке удалять, переставлять, изменять и добавлять элементы — или затрагивать только элементы за пределами экрана.
Макет SwipeRefreshLayout («Проведите пальцем для обновления»)
Позволяет обновлять содержимое представления вертикальным жестом смахивания.
Не используйте жест «проведите пальцем для обновления» в следующих случаях:
- Боковые панели навигации (navigation drawers)
- Виджеты на главном экране
- Панорамируемый контент

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

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

Не рекомендуется.
Расположение
Расположение жеста
Как правило, жест доступен в верхней части подборки контента, но может быть доступен и внизу — например, в чат-приложениях.
Положение индикатора обновления в состоянии покоя
В состоянии покоя индикатор обновления располагается по горизонтальному центру относительно обновляемого контента.

Правильно.

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

Не рекомендуется.
Положение индикатора обновления в активном состоянии
В активном состоянии индикатор обновления располагается вблизи верхней части обновляемого контента.
Его точное вертикальное положение в состоянии покоя можно скорректировать для визуальной согласованности с базовым макетом. Например, индикатор может размещаться на границе слоя Material или на линии сетки — при условии, что он остаётся вблизи верхней части обновляемого контента.

Правильно.

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