Перейти к содержанию

Alert

Запускает диалоговое окно предупреждения с указанным заголовком и сообщением.

Опционально предоставьте список кнопок. При нажатии на любую кнопку сработает соответствующий обратный вызов onPress и оповещение будет отключено. По умолчанию единственной кнопкой будет кнопка 'OK'.

Это API, который работает как на Android, так и на iOS и может показывать статические оповещения. Оповещения, предлагающие пользователю ввести некоторую информацию, доступны только на iOS.

Пример

iOS

На iOS вы можете указать любое количество кнопок. Каждая кнопка по желанию может задавать стиль или быть подчеркнутой, доступные опции представлены перечислением AlertButtonStyle и полем isPreferred в AlertButton.

Android

В Android можно указать не более трех кнопок. В Android есть понятие нейтральной, отрицательной и положительной кнопки:

  • Если вы укажете одну кнопку, она будет 'положительной' (например, 'OK').
  • Две кнопки означают 'отрицательный', 'положительный' (например, 'Отмена', 'OK')
  • Три кнопки означают 'нейтральный', 'отрицательный', 'положительный' (например, 'Позже', 'Отмена', 'OK')

Оповещения на Android можно отменить, нажав на кнопку за пределами поля оповещения. По умолчанию эта функция отключена, но ее можно включить, предоставив дополнительный параметр Options со свойством cancelable, установленным в true, т. е. {cancelable: true}.

Событие отмены может быть обработано путем предоставления свойства обратного вызова onDismiss внутри параметра options.

Пример

Методы

alert()

1
2
3
4
5
6
static alert (
  title: string,
  message?: string,
  buttons?: AlertButton[],
  options?: AlertOptions,
);

Параметры:

Имя Тип Описание
title (обязательно) string Заголовок диалога. Если передать null или пустую строку, то заголовок будет скрыт.
message string Необязательное сообщение, которое отображается под заголовком диалога.
buttons AlertButton Необязательный массив, содержащий конфигурацию кнопок.
options Options Дополнительная конфигурация Alert.

prompt()

1
2
3
4
5
6
7
8
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, когда пользователь нажмет кнопку 'OK'.
Если передать массив, то кнопки будут сконфигурированы на основе содержимого массива.
type AlertType При этом настраивается ввод текста.
defaultValue string Текст по умолчанию в текстовом вводе.
keyboardType string Тип клавиатуры первого текстового поля (если оно существует). Один из TextInput keyboardTypes.
options Options Дополнительная конфигурация Alert.

Определения типа

AlertButtonStyle

Стиль кнопки оповещения iOS.

Тип
enum

Константы:

Значение Описание
'default' Стиль кнопок по умолчанию.
'cancel' Стиль кнопки "Отмена".
'destructive' Деструктивный стиль кнопок.

AlertType

Тип оповещения iOS.

Тип
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

AlertButton

Объект, описывающий конфигурацию кнопки в оповещении.

Тип
array of objects

Свойства объектов:

Имя Тип Описание
text string Надпись на кнопке.
onPress function Функция обратного вызова при нажатии кнопки.
style AlertButtonStyle Стиль кнопки, на Android это свойство будет игнорироваться.
isPreferred boolean Следует ли выделять кнопку, на Android это свойство игнорируется.

AlertOptions

Тип
object

Свойства:

Имя Тип Описание
cancelable boolean Определяет, можно ли отключить предупреждение, нажав на него за пределами поля предупреждения.
userInterfaceStyle string Стиль интерфейса, используемый для оповещения, может быть установлен в light или dark, в противном случае будет использоваться системный стиль по умолчанию.
onDismiss function Функция обратного вызова, запускаемая при отклонении оповещения.

Комментарии