Android 당겨서 새로고침
당겨서 새로고침(Swipe to refresh)은 사용자가 제스처나 동작으로 화면 콘텐츠를 수동으로 새로고침할 수 있게 합니다.
사용 방법
당겨서 새로고침은 목록, 그리드 목록, 카드 컬렉션의 시작 부분(가장 최근 콘텐츠가 표시되는 인덱스 0 위치)에서 사용할 수 있는 스와이프 제스처입니다.
이 제스처는 일관된 위치에 업데이트가 자주 나타나며, 제스처를 사용한 후 사용자가 새 콘텐츠를 확인할 가능성이 높은 동적 콘텐츠에 가장 적합합니다.
새로고침 표시기
새로고침 표시기는 새로고침 제스처나 동작이 실행될 때만 표시됩니다. 동기화 중에는 표시되지 않습니다.
효과
새로고침 시 내용이 크게 달라질 수 있는 뷰에서 이 제스처를 사용하면, 변경 사항이 사용자에게 바로 드러나지 않을 수 있습니다. 예를 들어, 새로고침 결과로 항목이 순서와 관계없이 삭제, 재정렬, 수정, 삽입되거나, 화면 밖의 항목만 변경될 수 있습니다.
다음과 같은 상황에서는 당겨서 새로고침을 사용하면 안 됩니다:
- 내비게이션 드로어
- 홈 화면 위젯
- 이동(드래그)이 가능한 콘텐츠

권장하지 않음

권장하지 않음

권장하지 않음
동작 및 배치
동작
새로고침 표시기가 화면에 나타나며 커지는 동안, 원형 스피너는 회전하면서 서서히 선명해집니다.
새로고침 표시기는 새로고침이 완료되어 새 콘텐츠가 표시되거나, 사용자가 새로고침 중인 콘텐츠를 떠날 때까지 계속 표시됩니다.
권장
권장하지 않음
새로고침 표시기 전환
새로고침 중인 콘텐츠가 있는 표면 앞에 다른 표면이 있을 경우, 새로고침 표시기는 앞쪽 표면 뒤에서 나타나기 시작하며, 완전히 보일 때까지 일부가 가려진 채 표시됩니다.
다음과 같은 경우에는 새로고침 표시기가 이동함에 따라 커집니다:
- 새로고침 중인 머티리얼이 다른 모든 표면보다 높은 엘리베이션에 있을 때
- 앱 바 또는 오버플로 메뉴에서 새로고침이 시작될 때
임곗값 요구사항
의도하지 않은 새로고침을 방지하기 위해, 앱은 새로고침을 실행하기 전에 새로고침 표시기가 임곗값을 통과했는지 확인해야 합니다. 임곗값 통과 여부는 다음과 같은 신호로 판단할 수 있습니다:
- 원형 스피너의 불투명도가 100%에 도달함
- 원형 스피너의 회전 속도가 느려짐
- 새로고침 표시기의 이동 속도가 느려짐
임곗값을 통과한 상태에서 제스처를 완료하면 새로고침이 시작됩니다.
임곗값 아래로 제스처를 되돌리면 새로고침이 취소됩니다.
컴포넌트에서의 당겨서 새로고침
제스처 위치
일반적으로 새로고침 제스처는 콘텐츠 컬렉션 상단에서 사용할 수 있지만, 화면 하단에서도 사용할 수 있습니다.
새로고침 표시기 (가로 대기 위치)
새로고침 표시기는 대기 상태에서 새로고침 중인 콘텐츠를 기준으로 가로 중앙에 위치합니다.

권장

권장하지 않음

권장하지 않음
새로고침 표시기 (세로 대기 위치)
새로고침 표시기는 새로고침 중인 콘텐츠 상단 근처에 위치합니다.
레이아웃의 조화를 높이기 위해 세로 대기 위치를 조정할 수 있습니다. 예를 들어, 새로고침 중인 콘텐츠 상단 근처에 위치하기만 하면, 표면 가장자리나 레이아웃 그리드에 맞춰 배치할 수 있습니다.

권장

권장하지 않음