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