AlertIOS

AlertIOS provides functionality to create an iOS alert dialog with a message or create a prompt for user input.

Creating an iOS alert:

AlertIOS.alert(
 'Sync Complete',
 'All your data are belong to us.'
);

Creating an iOS prompt:

AlertIOS.prompt(
  'Enter a value',
  null,
  text => console.log("You entered "+text)
);

We recommend using the Alert.alert method for cross-platform support if you don't need to create iOS-only prompts.

Methods

Type Definitions

Reference

Methods

alert()

static alert(title: string, [message]: string, [callbackOrButtons]: ?(() => void), ButtonsArray, [type]: AlertType): [object Object]

Create and display a popup alert.

Parameters:

Name Type Required Description
title string Yes The dialog's title. Passing null or '' will hide the title.
message string No An optional message that appears below the dialog's title.
callbackOrButtons ?(() => void),ButtonsArray No This optional argument should be either a single-argument function or an array of buttons. If passed a function, it will be called when the user taps 'OK'. If passed an array of button configurations, each button should include a text key, as well as optional onPress and style keys. style should be one of 'default', 'cancel' or 'destructive'.
type AlertType No Deprecated, do not use.

Example with custom buttons:

AlertIOS.alert(
  'Update available',
  'Keep your app up to date to enjoy the latest features',
  [
    {
      text: 'Cancel',
      onPress: () => console.log('Cancel Pressed'),
      style: 'cancel',
    },
    {
      text: 'Install',
      onPress: () => console.log('Install Pressed'),
    },
  ]
);

prompt()

static prompt(title: string, [message]: string, [callbackOrButtons]: ?((text: string) => void), ButtonsArray, [type]: AlertType, [defaultValue]: string, [keyboardType]: string): [object Object]

Create and display a prompt to enter some text.

Parameters:

Name Type Required Description
title string Yes The dialog's title.
message string No An optional message that appears above the text input.
callbackOrButtons ?((text: string) => void),ButtonsArray No This optional argument should be either a single-argument function or an array of buttons. If passed a function, it will be called with the prompt's value when the user taps 'OK'. If passed an array of button configurations, each button should include a text key, as well as optional onPress and style keys (see example). style should be one of 'default', 'cancel' or 'destructive'.
type AlertType No This configures the text input. One of 'plain-text', 'secure-text' or 'login-password'.
defaultValue string No The default text in text input.
keyboardType string No The keyboard type of first text field(if exists). One of 'default', 'email-address', 'numeric', 'phone-pad', 'ascii-capable', 'numbers-and-punctuation', 'url', 'number-pad', 'name-phone-pad', 'decimal-pad', 'twitter' or 'web-search'.

Example with custom buttons:

AlertIOS.prompt(
  'Enter password',
  'Enter your password to claim your $1.5B in lottery winnings',
  [
    {
      text: 'Cancel',
      onPress: () => console.log('Cancel Pressed'),
      style: 'cancel',
    },
    {
      text: 'OK',
      onPress: (password) => console.log('OK Pressed, password: ' + password),
    },
  ],
  'secure-text'
);

,

Example with the default button and a custom callback:

AlertIOS.prompt(
  'Update username',
  null,
  (text) => console.log('Your username is ' + text),
  null,
  'default'
);

Type Definitions

AlertType

An Alert button type

Type
$Enum

Constants:

Value Description
default Default alert with no inputs
plain-text Plain text input alert
secure-text Secure text input alert
login-password Login and password alert

AlertButtonStyle

An Alert button style

Type
$Enum

Constants:

Value Description
default Default button style
cancel Cancel button style
destructive Destructive button style

ButtonsArray

Array or buttons

Type
Array

Properties:

Name Type Description
[text] string Button label
[onPress] function Callback function when button pressed
[style] AlertButtonStyle Button style

Constants:

Value Description
text Button label
onPress Callback function when button pressed
style Button style

© 2015–2018 Facebook Inc.
Licensed under the Creative Commons Attribution 4.0 International Public License.
https://facebook.github.io/react-native/docs/alertios.html