跳到主要内容

Alert

使用指定的标题和消息启动一个警告对话框。

可选择提供按钮列表。点击任何按钮将触发相应的 onPress 回调并关闭警告框。默认情况下,只有一个“确定”按钮。

这是一个在 Android 和 iOS 上都可用的 API,可以显示静态警告框。提示用户输入信息的 Alert 仅在 iOS 上可用。

示例

iOS

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

Android

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

  • 如果您指定一个按钮,它将是“肯定”按钮(例如“确定”)
  • 两个按钮表示“否定”、“肯定”(例如“取消”、“确定”)
  • 三个按钮表示“中性”、“否定”、“肯定”(例如“稍后”、“取消”、“确定”)

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

取消事件可以通过在 options 参数中提供 onDismiss 回调属性来处理。

示例
Android


参考

方法

alert()

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

参数

名称类型描述
title
必需
string对话框的标题。传递 null 或空字符串将隐藏标题。
messagestring一个可选的消息,显示在对话框标题下方。
buttonsAlertButton[]一个可选的数组,包含按钮配置。
optionsAlertOptions一个可选的 Alert 配置。

prompt()
iOS

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

创建并显示一个提示框,以 Alert 的形式输入一些文本。

参数

名称类型描述
title
必需
string对话框的标题。
messagestring一个可选的消息,显示在文本输入框上方。
callbackOrButtonsfunction
AlertButton[]
如果传递一个函数,它将在用户点击“确定”时使用提示框的值调用
(text: string) => void,当用户点击“确定”时。
如果传递一个数组,按钮将根据数组内容进行配置。
typeAlertType这配置了文本输入框。
defaultValuestring文本输入框中的默认文本。
keyboardTypestring第一个文本字段(如果存在)的键盘类型。TextInput keyboardTypes 之一。
optionsAlertOptions一个可选的 Alert 配置。

类型定义

AlertButtonStyle
iOS

一个 iOS Alert 按钮样式。

类型
enum

常量

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

AlertType
iOS

一个 iOS Alert 类型。

类型
enum

常量

描述
'default'没有输入的默认 Alert
'plain-text'纯文本输入 Alert
'secure-text'安全文本输入 Alert
'login-password'登录和密码 Alert

AlertButton

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

类型
对象数组

对象属性

名称类型描述
textstring按钮标签。
onPressfunction按钮被按下时的回调函数。
style
iOS
AlertButtonStyle按钮样式,在 Android 上此属性将被忽略。
isPreferred
iOS
boolean是否应强调按钮,在 Android 上此属性将被忽略。

AlertOptions

类型
object

属性

名称类型描述
cancelable
Android
boolean定义是否可以通过点击警告框外部来关闭警告框。
userInterfaceStyle
iOS
string用于警告框的界面样式,可以设置为 lightdark,否则将使用默认系统样式。
onDismiss
Android
function当警告框被关闭时触发的回调函数。