Skip to main content

React Native의 ToastAndroid API는 안드로이드 플랫폼의 ToastAndroid 모듈을 자바스크립트 모듈로 제공한다. 이 API는 show(message, duration) 메서드를 제공하며, 이 메서드는 다음과 같은 매개변수를 받는다:

  • message 토스트에 표시할 텍스트 문자열
  • duration 토스트의 지속 시간—ToastAndroid.SHORT 또는 ToastAndroid.LONG

또는 showWithGravity(message, duration, gravity)를 사용해 토스트가 화면의 어디에 나타날지 지정할 수 있다. ToastAndroid.TOP, ToastAndroid.BOTTOM, ToastAndroid.CENTER 중 하나를 선택할 수 있다.

showWithGravityAndOffset(message, duration, gravity, xOffset, yOffset) 메서드는 픽셀 단위로 오프셋을 지정할 수 있는 기능을 추가한다.

안드로이드 11(API 레벨 30)부터는 텍스트 토스트에 대해 gravity 설정이 적용되지 않는다. 변경 사항에 대해 여기에서 자세히 확인할 수 있다.

참조

메서드​

show()​

tsx
static show(message: string, duration: number);

showWithGravity()​

이 속성은 Android API 29 이하 버전에서만 작동한다. 더 높은 Android API에서 비슷한 기능을 사용하려면 snackbar나 notification을 고려해 보라.

tsx
static showWithGravity(message: string, duration: number, gravity: number);

showWithGravityAndOffset()​

이 속성은 Android API 29 이하에서만 동작한다. 더 높은 Android API에서 유사한 기능을 구현하려면 스낵바나 알림을 사용하는 것을 고려해 보자.

tsx
static showWithGravityAndOffset(
  message: string,
  duration: number,
  gravity: number,
  xOffset: number,
  yOffset: number,
);

속성​

SHORT​

화면에 표시되는 지속 시간을 나타낸다.

tsx
static SHORT: number;

LONG​

화면에 표시되는 지속 시간을 나타낸다.

tsx
static LONG: number;

TOP​

화면 상의 위치를 나타낸다.

tsx
static TOP: number;

BOTTOM​

화면 상의 위치를 나타낸다.

tsx
static BOTTOM: number;

CENTER​

화면 상의 위치를 나타낸다.

tsx
static CENTER: number;