ToastAndroid

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

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 级别 30）开始，设置重力（gravity）对文本 toast 不再生效。有关此变更的详情，请参阅此处。

---

参考

方法

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 上实现类似功能，请考虑使用 snackbar 或 notification。

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;