당겨서 새로고침(Swipe to refresh)
당겨서 새로고침은 사용자가 동작이나 제스처를 통해 화면 콘텐츠를 수동으로 새로 고치는 패턴입니다.
앱에서 콘텐츠를 업데이트하는 방법은 두 가지가 있습니다:
- 권장되는 방법은 동기화(sync)를 사용하여 콘텐츠를 자동으로 업데이트하는 것입니다. 이를 통해 앱 콘텐츠가 항상 최신 상태로 유지됩니다
- 당겨서 새로고침은 최신 콘텐츠 순으로 정렬된 목록, 그리드 목록, 카드 컬렉션의 시작 부분에서 사용할 수 있는 스와이프 제스처입니다
수동 새로고침은 동기화를 보완하는 역할을 하며, Gmail에서 새 메일을 확인할 때처럼 현재 스크롤 위치를 유지한 상태로 콘텐츠를 갱신합니다.
아이콘
새로고침 인디케이터는 원형 스피너, 즉 회전하는 원형 곡선 화살표 아이콘으로 표현됩니다.
위치
- 당겨서 새로고침 제스처는 콘텐츠 컬렉션의 상단 또는 하단에서 사용할 수 있습니다
- 새로고침 인디케이터의 대기 위치는 새로고침되는 콘텐츠를 기준으로 가로 중앙에 배치됩니다
임계값
앱이 새로고침을 실행하려면 새로고침 인디케이터가 먼저 임계값을 통과해야 합니다. 이는 원형 스피너의 불투명도, 회전 속도, 이동의 변화로 나타납니다.

사용법
당겨서 새로고침은 최신 콘텐츠가 표시되는(인덱스 0) 목록, 그리드 목록, 카드 컬렉션의 시작 부분에서 사용할 수 있는 스와이프 제스처입니다.
이 제스처는 업데이트가 일관된 위치에서 자주 발생하고, 사용자가 제스처를 실행한 후 새 콘텐츠를 볼 가능성이 높은 동적 콘텐츠에 사용하는 것이 가장 좋습니다.
새로고침 인디케이터
새로고침 인디케이터는 당겨서 새로고침 제스처나 새로고침 작업이 있을 때만 표시됩니다. 동기화가 진행될 때는 표시되지 않습니다.
콘텐츠 변화
새로 고침 시 크게 변할 수 있는 뷰에서 이 제스처를 사용하면, 그 변화가 사용자에게 바로 드러나지 않을 수 있습니다. 예를 들어, 새로고침으로 인해 항목이 비순차적으로 삭제, 재정렬, 수정, 삽입되거나 화면 밖의 항목만 변경될 수 있습니다.
세로 스와이프 제스처로 뷰의 콘텐츠를 새로 고칩니다
당겨서 새로고침은 다음과 같은 상황에서 사용하면 안 됩니다:
- 내비게이션 드로어
- 홈 화면 위젯
- 이동 가능한 콘텐츠

비권장

비권장

비권장
위치 지정
제스처 위치
일반적으로 이 제스처는 콘텐츠 컬렉션의 상단에서 사용하지만, 채팅 앱처럼 하단에서 사용할 수도 있습니다.
새로고침 인디케이터 대기 위치
새로고침 인디케이터는 대기 상태일 때 새로고침되는 콘텐츠를 기준으로 가로 중앙에 배치됩니다.

권장

비권장

비권장
새로고침 인디케이터 활성 위치
새로고침 인디케이터는 새로고침되는 콘텐츠의 상단 근처에 위치합니다.
정확한 세로 위치는 기본 레이아웃과 시각적으로 조화를 이루도록 조정할 수 있습니다. 예를 들어, 새로고침되는 콘텐츠의 상단 근처에 있는 한 인디케이터는 Material 가장자리나 그리드 라인에 놓일 수 있습니다.

권장

비권장
동작
새로고침 인디케이터가 화면으로 이동하거나 크기가 조정되어 나타나는 동안, 원형 스피너는 회전하면서 서서히 나타납니다.
새로고침 인디케이터는 새로고침 작업이 완료되어 새 콘텐츠가 표시될 때까지, 또는 사용자가 새로고침되는 콘텐츠에서 벗어날 때까지 계속 표시됩니다.
권장
비권장
새로고침 인디케이터 전환
새로고침되는 콘텐츠가 있는 Material 앞에 다른 표면이 있을 때, 새로고침 인디케이터는 그 표면 아래에서부터 이동해 나오며 완전히 보일 때까지 잘려서 표시됩니다.
다음의 경우 새로고침 인디케이터는 이동하면서 크기가 커집니다:
- 새로고침되는 Material이 다른 모든 표면보다 높은 위치에 있을 때
- 앱 바 또는 오버플로 메뉴 작업을 통해 콘텐츠 새로고침이 시작될 때
임계값 요구 사항
당겨서 새로고침 제스처가 의도한 대로 사용되도록 하기 위해, 앱이 새로고침을 실행하기 전에 새로고침 인디케이터가 임계값을 통과해야 합니다. 이 임계값은 다음과 같은 여러 신호로 표시됩니다:
- 원형 스피너의 불투명도가 100%에 도달합니다
- 원형 스피너의 회전 속도가 느려집니다
- 새로고침 인디케이터의 이동 속도가 느려집니다
임계값을 통과한 후 제스처를 완료하면 새로고침이 시작됩니다.
임계값을 넘은 후 제스처를 반대로 되돌리면 새로고침이 취소됩니다.