Alert

启动一个提示对话框，包含对应的标题和信息。

你还可以指定一系列的按钮，点击对应的按钮会调用对应的 onPress 回调并且关闭提示框。默认情况下，对话框会仅有一个'确定'按钮。

本接口可以在 iOS 和 Android 上显示一个静态的提示框。只有 iOS 系统支持在提示框中加入文本框。

示例

函数式组件

Class 组件

iOS

在 iOS 上你可以指定任意数量的按钮。每个按钮还都可以指定自己的样式，此外还可以指定提示的类别。参阅AlertButtonStyle来了解更多细节。

Android

在 Android 上最多能指定三个按钮，这三个按钮分别具有“中间态”、“消极态”和“积极态”的概念：

如果你只指定一个按钮，则它具有“积极态”的属性（比如“确定”）；两个按钮，则分别是“消极态”和“积极态”（比如“取消”和“确定”）；三个按钮则意味着“中间态”、“消极态”和“积极态”（比如“稍候再说”，“取消”，“确定”）。

在 Android 上可以通过点击提示框的外面来取消提示框，但这一行为默认没有启用。你可以在Options中提供一个额外参数来启用这一行为：{ cancelable: true }。

还可以通过在options中添加onDismiss回调函数来捕获用户的取消操作：{ onDismiss: () => {} }。

示例

Android

---

文档

方法

alert()

static alert(title, message?, buttons?, options?)

参数：

名称	类型	说明
title	string Required	The dialog's title. Passing null or empty string will hide the title.
message	string	An optional message that appears below the dialog's title.
buttons	Buttons	An optional array containg buttons configuration.
options	Options Android	An optional Alert configuration for the Android.

---

prompt()

iOS

static prompt(title, message?, callbackOrButtons?, type?, defaultValue?, keyboardType?)

Create and display a prompt to enter some text in form of Alert.

参数：

名称	类型	说明
title	string Required	The dialog's title.
message	string	An optional message that appears above the text input.
callbackOrButtons	function Buttons	If passed a function, it will be called with the prompt's value (text: string) => void, when the user taps 'OK'. If passed an array, buttons will be configured based on the array content.
类型	AlertType	This configures the text input.
defaultValue	string	The default text in text input.
keyboardType	string	The keyboard type of first text field (if exists). One of TextInput keyboardTypes.

---

类型定义

AlertButtonStyle

iOS

An iOS Alert button style.

类型
enum

常量：

Value	说明
'default'	Default button style.
'cancel'	Cancel button style.
'destructive'	Destructive button style.

---

AlertType

iOS

An iOS Alert type.

类型
enum

常量：

值	说明
'default'	Default alert with no inputs
'plain-text'	Plain text input alert
'secure-text'	Secure text input alert
'login-password'	Login and password alert

---

Buttons

Array of objects containg Alert buttons configuration.

类型
array of objects

Objects properties:

名称	类型	说明
text	string	Button label.
onPress	function	Callback function when button is pressed.
style iOS	AlertButtonStyle	Button style, on Android this property will be ignored.

---

Options

Android

类型
object

属性：

名称	类型	说明
cancelable	boolean	Defines if alert can be dismissed by tapping outside of the alert box.
onDismiss	function	Callback function fired when alert has been dismissed.