Skip to main content
Version: 0.70

ToastAndroid

React Native's ToastAndroid API exposes the Android platform's ToastAndroid module as a JS module. It provides the method show(message, duration) which takes the following parameters:

  • message A string with the text to toast
  • duration The duration of the toast—either ToastAndroid.SHORT or ToastAndroid.LONG

You can alternatively use showWithGravity(message, duration, gravity) to specify where the toast appears in the screen's layout. May be ToastAndroid.TOP, ToastAndroid.BOTTOM or ToastAndroid.CENTER.

The 'showWithGravityAndOffset(message, duration, gravity, xOffset, yOffset)' method adds the ability to specify an offset with in pixels.

Imperative hack​

The ToastAndroid API is imperative, but there is a way to expose a declarative component from it as in this example:

Reference

Methods​

show()​

jsx
static show(message, duration)

showWithGravity()​

jsx
static showWithGravity(message, duration, gravity)

showWithGravityAndOffset()​

jsx
static showWithGravityAndOffset(message, duration, gravity, xOffset, yOffset)

Properties​

SHORT​

Indicates the duration on the screen.

jsx
ToastAndroid.SHORT;

LONG​

Indicates the duration on the screen.

jsx
ToastAndroid.LONG;

TOP​

Indicates the position on the screen.

jsx
ToastAndroid.TOP;

BOTTOM​

Indicates the position on the screen.

jsx
ToastAndroid.BOTTOM;

CENTER​

Indicates the position on the screen.

jsx
ToastAndroid.CENTER;