ToastAndroid

React Native 的 ToastAndroid API 将 Android 平台的 ToastAndroid 模块作为一个 JS 模块暴露出来。它提供了 show(message, duration) 方法，接收以下参数：

• message 要显示为 toast 的文本字符串
• 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 级别 30）开始，设置 gravity 对文本 toast 不再生效。有关这些变更，请阅读这里。

---

参考

方法

show()

React TSX

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

---

showWithGravity()

此属性仅适用于 Android API 29 及以下版本。对于更高版本的 Android API 上的类似功能，请考虑使用 snackbar 或通知。

React TSX

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

---

showWithGravityAndOffset()

此属性仅适用于 Android API 29 及以下版本。对于更高版本的 Android API 上的类似功能，请考虑使用 snackbar 或通知。

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;