Skip to content
Material Design 2
Main Navigation
v3
v2
v1

한국어

English
简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
Italiano
Polski
Türkçe
čeština
magyar

한국어

English
简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
Italiano
Polski
Türkçe
čeština
magyar

외관

Sidebar Navigation

Material 시스템

소개

머티리얼 스터디

머티리얼 스터디 소개

Basil

Crane

Fortnightly

Owl

Rally

Reply

Shrine

Material 기초

환경

표면

엘리베이션

빛과 그림자

레이아웃

레이아웃 이해하기

픽셀 밀도

반응형 레이아웃 그리드

간격 방법

컴포넌트 동작

밀도 적용

내비게이션

내비게이션 이해

내비게이션 전환

검색

색상

색상 시스템

UI에 색상 적용하기

색상 사용

텍스트 가독성

다크 테마

타이포그래피

타입 시스템

타이포그래피 이해하기

언어 지원

사운드

사운드 소개

UI에 사운드 적용

사운드 속성

사운드 연출

아이코노그래피

제품 아이콘

시스템 아이콘

애니메이션 아이콘

모양

모양 소개

모양과 계층 구조

표현 수단으로서의 모양

모양과 모션(Shape and motion)

UI에 모양 적용하기

모션

모션 이해하기

모션 시스템

속도

코레오그래피(Choreography)

맞춤 설정

상호작용

제스처

선택

상태

커뮤니케이션

확인 및 알림

데이터 형식

데이터 시각화

빈 상태

도움말 및 피드백

이미지

시작 화면

온보딩

오프라인 상태

작성 지침

머신러닝

머신러닝 패턴

객체 감지: 실시간 카메라

객체 감지: 정적 이미지

바코드 스캔

Material 가이드라인

Material Theming

개요

테마 구현

사용성

접근성

양방향성

플랫폼 가이드라인

Android 바

Android 지문

Android 햅틱

Android 아이콘

Android 앱 간 이동

Android 알림

Android 권한

Android 슬라이스

Android 분할 화면

Android 당겨서 새로고침

Android 텍스트 선택 툴바

Android 위젯

크로스 플랫폼 적응

컴포넌트

앱 바: 하단

앱 바: 상단

백드롭

배너

하단 내비게이션

버튼

버튼: 플로팅 작업 버튼

카드

체크박스

칩

데이터 표

날짜 선택기

대화상자

구분선

이미지 목록

목록

메뉴

내비게이션 드로어

탐색 레일

진행 표시기

라디오 버튼

바텀 시트

시트: 사이드

슬라이더

스낵바

스위치

탭

텍스트 필드

시간 선택기

툴팁

이 페이지에서

Android 당겨서 새로고침 ​

당겨서 새로고침(Swipe to refresh)은 사용자가 제스처나 동작으로 화면 콘텐츠를 수동으로 새로고침할 수 있게 합니다.

사용 방법 ​

당겨서 새로고침은 목록, 그리드 목록, 카드 컬렉션의 시작 부분(가장 최근 콘텐츠가 표시되는 인덱스 0 위치)에서 사용할 수 있는 스와이프 제스처입니다.

이 제스처는 일관된 위치에 업데이트가 자주 나타나며, 제스처를 사용한 후 사용자가 새 콘텐츠를 확인할 가능성이 높은 동적 콘텐츠에 가장 적합합니다.

새로고침 표시기 ​

새로고침 표시기는 새로고침 제스처나 동작이 실행될 때만 표시됩니다. 동기화 중에는 표시되지 않습니다.

효과

새로고침 시 내용이 크게 달라질 수 있는 뷰에서 이 제스처를 사용하면, 변경 사항이 사용자에게 바로 드러나지 않을 수 있습니다. 예를 들어, 새로고침 결과로 항목이 순서와 관계없이 삭제, 재정렬, 수정, 삽입되거나, 화면 밖의 항목만 변경될 수 있습니다.

당겨서 새로고침을 보여주는 애니메이션

다음과 같은 상황에서는 당겨서 새로고침을 사용하면 안 됩니다:

  • 내비게이션 드로어
  • 홈 화면 위젯
  • 이동(드래그)이 가능한 콘텐츠
내비게이션 드로어에 새로고침 표시기를 배치하지 마세요

권장하지 않음

내비게이션 드로어에 새로고침 표시기를 배치하지 마세요.

홈 화면 위젯처럼 자동으로 업데이트되어야 하는 영역에는 새로고침 표시기를 표시하지 마세요

권장하지 않음

홈 화면 위젯처럼 자동으로 업데이트되어야 하는 영역에는 새로고침 표시기를 표시하지 마세요.
지도처럼 이동(드래그)이 가능한 콘텐츠에는 새로고침 표시기를 표시하지 마세요

권장하지 않음

지도처럼 이동(드래그)이 가능한 콘텐츠에는 새로고침 표시기를 표시하지 마세요. 이 영역에서는 스와이프 제스처가 이미 다른 동작에 할당되어 있기 때문입니다.

당겨서 새로고침 레이아웃

세로 스와이프 제스처를 통해 뷰의 콘텐츠를 새로고침합니다.

관련 문서

동작 및 배치 ​

동작 ​

새로고침 표시기가 화면에 나타나며 커지는 동안, 원형 스피너는 회전하면서 서서히 선명해집니다.

새로고침 표시기는 새로고침이 완료되어 새 콘텐츠가 표시되거나, 사용자가 새로고침 중인 콘텐츠를 떠날 때까지 계속 표시됩니다.

권장

새로고침 상태를 사용자에게 보여주기 위해, 새로고침이 완료될 때까지 새로고침 표시기를 화면에 유지하세요.

권장하지 않음

새로고침 표시기를 화면 밖으로 스크롤하지 마세요. 새로고침 상태가 가려질 뿐만 아니라, 새로고침이 전체 화면이 아니라 카드와 같은 특정 컴포넌트에만 적용되는 것처럼 보일 수 있습니다.

새로고침 표시기 전환 ​

새로고침 중인 콘텐츠가 있는 표면 앞에 다른 표면이 있을 경우, 새로고침 표시기는 앞쪽 표면 뒤에서 나타나기 시작하며, 완전히 보일 때까지 일부가 가려진 채 표시됩니다.

다음과 같은 경우에는 새로고침 표시기가 이동함에 따라 커집니다:

  • 새로고침 중인 머티리얼이 다른 모든 표면보다 높은 엘리베이션에 있을 때
  • 앱 바 또는 오버플로 메뉴에서 새로고침이 시작될 때

다른 표면과 동일 평면에 있는 새로고침 중인 콘텐츠.
z축에서 다른 표면 아래에 있는 새로고침 중인 콘텐츠.

앱 바 동작으로 새로고침되는 콘텐츠.

임곗값 요구사항 ​

의도하지 않은 새로고침을 방지하기 위해, 앱은 새로고침을 실행하기 전에 새로고침 표시기가 임곗값을 통과했는지 확인해야 합니다. 임곗값 통과 여부는 다음과 같은 신호로 판단할 수 있습니다:

  • 원형 스피너의 불투명도가 100%에 도달함
  • 원형 스피너의 회전 속도가 느려짐
  • 새로고침 표시기의 이동 속도가 느려짐

임곗값을 통과한 상태에서 제스처를 완료하면 새로고침이 시작됩니다.

임곗값 아래로 제스처를 되돌리면 새로고침이 취소됩니다.

컴포넌트에서의 당겨서 새로고침 ​

제스처 위치 ​

일반적으로 새로고침 제스처는 콘텐츠 컬렉션 상단에서 사용할 수 있지만, 화면 하단에서도 사용할 수 있습니다.

새로고침 표시기 (가로 대기 위치) ​

새로고침 표시기는 대기 상태에서 새로고침 중인 콘텐츠를 기준으로 가로 중앙에 위치합니다.

권장: 새로고침 중인 콘텐츠를 기준으로 새로고침 표시기를 가로 중앙에 정렬하세요

권장

새로고침 중인 콘텐츠를 기준으로 새로고침 표시기를 가로 중앙에 정렬하세요.
새로고침 표시기를 새로고침 중인 콘텐츠의 한쪽으로 치우치게 배치하지 마세요

권장하지 않음

새로고침 표시기를 새로고침 중인 콘텐츠의 한쪽으로 치우치게 배치하지 마세요.

권장하지 않음: 새로고침 표시기를 예상치 못한 위치에 배치하여 새로고침 중인 콘텐츠와의 관계가 모호해짐

권장하지 않음

새로고침 표시기를 예상치 못한 위치에 배치하면 새로고침 중인 콘텐츠와의 관계가 모호해집니다.

새로고침 표시기 (세로 대기 위치) ​

새로고침 표시기는 새로고침 중인 콘텐츠 상단 근처에 위치합니다.

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

권장: 새로고침 중인 콘텐츠 상단 근처에 새로고침 표시기를 배치하세요

권장

새로고침 중인 콘텐츠 상단 근처에 새로고침 표시기를 배치하세요.
콘텐츠를 가리는 세로 위치에 새로고침 표시기를 배치하지 마세요

권장하지 않음

콘텐츠를 가리는 세로 위치에 새로고침 표시기를 배치하지 마세요.
Pager
이전Android 분할 화면
다음Android 텍스트 선택 툴바

Apache-2.0 라이선스 하에 배포되었습니다.

Copyright © 2018-Present Google

https://m2.material.io/design/platform-guidance/android-swipe-to-refresh.html

Apache-2.0 라이선스 하에 배포되었습니다.

Copyright © 2018-Present Google