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 |
|
Параметры:
Имя | Тип | Описание |
---|---|---|
title (обязательно) | string | Заголовок диалога. Если передать null или пустую строку, то заголовок будет скрыт. |
message | string | Необязательное сообщение, которое отображается под заголовком диалога. |
buttons | AlertButton | Необязательный массив, содержащий конфигурацию кнопок. |
options | Options | Дополнительная конфигурация Alert. |
prompt() ¶
1 2 3 4 5 6 7 8 |
|
Создайте и выведите на экран подсказку для ввода некоторого текста в форме Alert
.
Параметры:
Имя | Тип | Описание |
---|---|---|
title (обязательно) | string | Заголовок диалога. |
message | string | Необязательное сообщение, которое отображается над вводимым текстом. |
callbackOrButtons | functionAlertButton | Если передать функцию, то она будет вызвана со значением подсказки(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 | Функция обратного вызова, запускаемая при отклонении оповещения. |