Alert

显示一个包含指定标题和消息的警告对话框。

可选地提供一个按钮列表。点击任何按钮都会触发相应的 onPress 回调并关闭警告。默认情况下，只有一个“OK”按钮。

这是一个同时适用于 Android 和 iOS 的 API，可以显示静态警告。用于提示用户输入信息的警告仅在 iOS 上可用。

示例

iOS

在 iOS 上，您可以指定任意数量的按钮。每个按钮都可以选择指定样式或被强调，可用选项由 AlertButtonStyle 枚举和 AlertButton 中的 isPreferred 字段表示。

Android

在 Android 上，最多可以指定三个按钮。Android 有一个中性、否定和肯定按钮的概念。

• 如果您指定一个按钮，它将是“肯定”按钮（例如“OK”）。
• 两个按钮代表“否定”、“肯定”（例如“Cancel”、“OK”）。
• 三个按钮代表“中性”、“否定”、“肯定”（例如“Later”、“Cancel”、“OK”）。

可以通过点击警告框外部来关闭 Android 上的警告。默认情况下禁用此功能，可以通过提供一个可选的 AlertOptions 参数并将 cancelable 属性设置为 true 来启用，例如：
{cancelable: true}.

可以通过在 options 参数内提供 onDismiss 回调属性来处理关闭事件。

示例

Android

---

参考

方法

alert()

tsx

static alert (
  title: string,
  message?: string,
  buttons?: AlertButton[],
  options?: AlertOptions,
);

参数

姓名	类型	描述
标题 必需	字符串	对话框的标题。传入 null 或空字符串将隐藏标题。
message	字符串	对话框标题下方出现的可选消息。
buttons	AlertButton[]	包含按钮配置的可选数组。
选项	AlertOptions	可选的 Alert 配置。

---

prompt()

iOS

tsx

static prompt: (
  title: string,
  message?: string,
  callbackOrButtons?: ((text: string) => void) | AlertButton[],
  type?: AlertType,
  defaultValue?: string,
  keyboardType?: string,
);

创建并显示一个用于在 Alert 形式中输入文本的提示。

参数

姓名	类型	描述
标题 必需	字符串	对话框的标题。
message	字符串	出现在文本输入框之上的可选消息。
callbackOrButtons	函数 AlertButton[]	如果传入函数，当用户点击“OK”时，该函数将以提示的文本值作为参数被调用。 (text: string) => void。 如果传入数组，按钮将根据数组内容进行配置。
类型	AlertType	配置文本输入框。
defaultValue	字符串	文本输入框中的默认文本。
keyboardType	字符串	第一个文本字段（如果存在）的键盘类型。是 TextInput keyboardTypes 之一。
选项	AlertOptions	可选的 Alert 配置。

---

类型定义

AlertButtonStyle

iOS

iOS Alert 按钮样式。

类型
enum

常量

值	描述
'default'	默认按钮样式。
'cancel'	取消按钮样式。
'destructive'	破坏性按钮样式。

---

AlertType

iOS

iOS Alert 类型。

类型
enum

常量

值	描述
'default'	默认的无输入警告
'plain-text'	纯文本输入警告
'secure-text'	安全文本输入警告
'login-password'	登录和密码警告

---

AlertButton

描述警告中按钮配置的对象。

类型
对象数组

对象属性

姓名	类型	描述
文本	字符串	按钮标签。
按下	函数	按下按钮时调用的回调函数。
style iOS	AlertButtonStyle	按钮样式，在 Android 上此属性将被忽略。
isPreferred iOS	布尔值	按钮是否应被强调，在 Android 上此属性将被忽略。

---

AlertOptions

类型
对象

属性

姓名	类型	描述
cancelable Android	布尔值	定义警告是否可以通过点击警告框外部来关闭。
userInterfaceStyle iOS	字符串	用于警告的用户界面样式，可以设置为 light 或 dark，否则将使用默认的系统样式。
onDismiss Android	函数	警告关闭时触发的回调函数。