跳到主要内容

ToastAndroid

React Native 的 ToastAndroid API 将 Android 平台的 ToastAndroid 模块作为 JS 模块公开。它提供了 show(message, duration) 方法，该方法接受以下参数：

  • message 要显示的文本字符串
  • duration toast 的持续时间，可以是 ToastAndroid.SHORT 或 ToastAndroid.LONG

你也可以使用 showWithGravity(message, duration, gravity) 来指定 toast 在屏幕布局中的显示位置。可以是 ToastAndroid.TOP、ToastAndroid.BOTTOM 或 ToastAndroid.CENTER。

showWithGravityAndOffset(message, duration, gravity, xOffset, yOffset) 方法增加了以像素指定偏移量的功能。

备注

从 Android 11（API level 30）开始，设置 gravity 对文本 toast 不再起作用。请在此处阅读相关变更。

参考

方法​

show()​

React TSX
static show(message: string, duration: number);

showWithGravity()​

此属性仅适用于 Android API 29 及更低版本。对于更高版本的 Android API，如需类似功能，请考虑使用 snackbar 或 notification。

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

showWithGravityAndOffset()​

此属性仅适用于 Android API 29 及更低版本。对于更高版本的 Android API，如需类似功能，请考虑使用 snackbar 或 notification。

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

属性​

SHORT​

表示在屏幕上的持续时间。

React TSX
static SHORT: number;

LONG​

表示在屏幕上的持续时间。

React TSX
static LONG: number;

TOP​

表示在屏幕上的位置。

React TSX
static TOP: number;

BOTTOM​

表示在屏幕上的位置。

React TSX
static BOTTOM: number;

CENTER​

表示在屏幕上的位置。

React TSX
static CENTER: number;