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 或空字符串将隐藏标题。 |
message | string | 一个可选的消息,显示在对话框标题下方。 |
buttons | AlertButton[] | 一个可选的数组,包含按钮配置。 |
options | AlertOptions | 一个可选的 Alert 配置。 |
prompt()
iOS
tsx
static prompt: (
title: string,
message?: string,
callbackOrButtons?: ((text: string) => void) | AlertButton[],
type?: AlertType,
defaultValue?: string,
keyboardType?: string,
);
创建并显示一个提示框,以 Alert 的形式输入一些文本。
参数
名称 | 类型 | 描述 |
---|---|---|
title 必需 | string | 对话框的标题。 |
message | string | 一个可选的消息,显示在文本输入框上方。 |
callbackOrButtons | function AlertButton[] | 如果传递一个函数,它将在用户点击“确定”时使用提示框的值调用(text: string) => void ,当用户点击“确定”时。如果传递一个数组,按钮将根据数组内容进行配置。 |
type | AlertType | 这配置了文本输入框。 |
defaultValue | string | 文本输入框中的默认文本。 |
keyboardType | string | 第一个文本字段(如果存在)的键盘类型。TextInput keyboardTypes 之一。 |
options | AlertOptions | 一个可选的 Alert 配置。 |
类型定义
AlertButtonStyleiOS
一个 iOS Alert 按钮样式。
类型 |
---|
enum |
常量
值 | 描述 |
---|---|
'default' | 默认按钮样式。 |
'cancel' | 取消按钮样式。 |
'destructive' | 破坏性按钮样式。 |
AlertTypeiOS
一个 iOS Alert 类型。
类型 |
---|
enum |
常量
值 | 描述 |
---|---|
'default' | 没有输入的默认 Alert |
'plain-text' | 纯文本输入 Alert |
'secure-text' | 安全文本输入 Alert |
'login-password' | 登录和密码 Alert |
AlertButton
一个描述警告框中按钮配置的对象。
类型 |
---|
对象数组 |
对象属性
名称 | 类型 | 描述 |
---|---|---|
text | string | 按钮标签。 |
onPress | function | 按钮被按下时的回调函数。 |
style iOS | AlertButtonStyle | 按钮样式,在 Android 上此属性将被忽略。 |
isPreferred iOS | boolean | 是否应强调按钮,在 Android 上此属性将被忽略。 |
AlertOptions
类型 |
---|
object |
属性
名称 | 类型 | 描述 |
---|---|---|
cancelable Android | boolean | 定义是否可以通过点击警告框外部来关闭警告框。 |
userInterfaceStyle iOS | string | 用于警告框的界面样式,可以设置为 light 或 dark ,否则将使用默认系统样式。 |
onDismiss Android | function | 当警告框被关闭时触发的回调函数。 |