cordova-plugin-dialogs

Этот плагин предоставляет доступ к некоторым элементам пользовательского интерфейса диалоговых окон нативных платформ через глобальный объект navigator.notification.

Несмотря на то, что этот объект прикреплён к глобальному пространству имён navigator, он недоступен до события deviceready.

document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
    console.log(navigator.notification);
}

Сообщайте о проблемах на следящей за ошибками системе Apache Cordova.

Установка

cordova plugin add cordova-plugin-dialogs

Методы

• navigator.notification.alert
• navigator.notification.confirm
• navigator.notification.prompt
• navigator.notification.beep

navigator.notification.alert

Отображает пользовательское диалоговое окно с предупреждением. Большинство реализаций Cordova используют для этого нативное диалоговое окно, но некоторые платформы используют функцию браузера alert, которая, как правило, менее настраиваема.

navigator.notification.alert(message, alertCallback, [title], [buttonName])

• message: Сообщение диалога. (Строка)

• alertCallback: Обратный вызов для вызова при закрытии диалогового окна с предупреждением. (Функция)

• title: Заголовок диалога. (Строка) (Необязательно, по умолчанию Alert)

• buttonName: Название кнопки. (Строка) (Необязательно, по умолчанию OK)

Пример

function alertDismissed() {
    // do something
}

navigator.notification.alert(
    'You are the winner!',  // message
    alertDismissed,         // callback
    'Game Over',            // title
    'Done'                  // buttonName
);

Поддерживаемые платформы

• Amazon Fire OS
• Android
• BlackBerry 10
• Браузер
• Firefox OS
• iOS
• Tizen
• Windows Phone 7 и 8
• Windows 8
• Windows

Особенности Windows Phone 7 и 8

• Встроенного диалогового окна браузера нет, но вы можете связать его, как показано ниже, для вызова alert() в глобальном пространстве имён:

  window.alert = navigator.notification.alert;
  

• Оба alert и confirm являются асинхронными вызовами, результаты которых доступны только асинхронно.

Особенности Firefox OS:

Доступны как блокирующие нативные вызовы window.alert(), так и неблокирующие navigator.notification.alert().

Особенности BlackBerry 10

Параметр обратного вызова navigator.notification.alert('text', callback, 'title', 'text') получает значение 1.

navigator.notification.confirm

Отображает настраиваемое диалоговое окно подтверждения.

navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])

• message: Сообщение диалога. (Строка)

• confirmCallback: Обратный вызов, который вызывается с индексом нажатой кнопки (1, 2 или 3) или при закрытии диалогового окна без нажатия кнопки (0). (Функция)

• title: Заголовок диалога. (Строка) (Необязательно, по умолчанию Confirm)

• buttonLabels: Массив строк, определяющих метки кнопок. (Массив) (Необязательно, по умолчанию [OK,Cancel])

confirmCallback

Обратный вызов confirmCallback выполняется, когда пользователь нажимает на одну из кнопок в диалоговом окне подтверждения.

Обратный вызов принимает аргумент buttonIndex (Число), который представляет собой индекс нажатой кнопки. Обратите внимание, что индекс использует нумерацию с единицы, поэтому значение является 1, 2, 3, и так далее.

Пример

function onConfirm(buttonIndex) {
    alert('You selected button ' + buttonIndex);
}

navigator.notification.confirm(
    'You are the winner!', // message
     onConfirm,            // callback to invoke with index of button pressed
    'Game Over',           // title
    ['Restart','Exit']     // buttonLabels
);

Поддерживаемые платформы

• Amazon Fire OS
• Android
• BlackBerry 10
• Браузер
• Firefox OS
• iOS
• Tizen
• Windows Phone 7 и 8
• Windows 8
• Windows

Особенности Windows Phone 7 и 8

• Встроенной функции браузера для window.confirm нет, но её можно связать, назначив:

  window.confirm = navigator.notification.confirm;
  

• Вызовы alert и confirm являются асинхронными, поэтому результат доступен только асинхронно.

Особенности Windows

• В Windows 8/8.1 невозможно добавить более трёх кнопок к экземпляру MessageDialog.

• В Windows Phone 8.1 невозможно отобразить диалоговое окно с более чем двумя кнопками.

Особенности Firefox OS:

Доступны как блокирующие нативные вызовы window.confirm(), так и неблокирующие navigator.notification.confirm().

navigator.notification.prompt

Отображает нативное диалоговое окно, более настраиваемое, чем функция браузера prompt.

navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])

• message: Сообщение диалога. (Строка)

• promptCallback: Обратный вызов, который вызывается с индексом нажатой кнопки (1, 2 или 3) или при закрытии диалогового окна без нажатия кнопки (0). (Функция)

• title: Заголовок диалога (Строка) (Необязательно, по умолчанию Prompt)

• buttonLabels: Массив строк, определяющих метки кнопок (Массив) (Необязательно, по умолчанию ["OK","Cancel"])

• defaultText: Значение текстового поля по умолчанию (String) (Необязательно, по умолчанию: пустая строка)

promptCallback

Обратный вызов promptCallback выполняется, когда пользователь нажимает на одну из кнопок в диалоговом окне ввода. Объект results, переданный в обратный вызов, содержит следующие свойства:

• buttonIndex: Индекс нажатой кнопки. (Число) Обратите внимание, что индекс использует нумерацию с единицы, поэтому значение является 1, 2, 3, и так далее.

• input1: Введённый текст в диалоговом окне ввода. (Строка)

Пример

function onPrompt(results) {
    alert("You selected button number " + results.buttonIndex + " and entered " + results.input1);
}

navigator.notification.prompt(
    'Please enter your name',  // message
    onPrompt,                  // callback to invoke
    'Registration',            // title
    ['Ok','Exit'],             // buttonLabels
    'Jane Doe'                 // defaultText
);

Поддерживаемые платформы

• Amazon Fire OS
• Android
• Браузер
• Firefox OS
• iOS
• Windows Phone 7 и 8
• Windows 8
• Windows

Особенности Android

• Android поддерживает максимум три кнопки и игнорирует любые дополнительные.

• На Android 3.0 и более поздних версиях кнопки отображаются в обратном порядке на устройствах, использующих тему Holo.

Особенности Windows

• В Windows диалоговое окно ввода основано на HTML из-за отсутствия соответствующего нативного API.

Особенности Firefox OS:

Доступны как блокирующие нативные вызовы window.prompt(), так и неблокирующие navigator.notification.prompt().

navigator.notification.beep

Устройство воспроизводит звуковой сигнал.

navigator.notification.beep(times);

• times: Количество повторений сигнала. (Число)

Пример

// Beep twice!
navigator.notification.beep(2);

Поддерживаемые платформы

• Amazon Fire OS
• Android
• BlackBerry 10
• Браузер
• iOS
• Tizen
• Windows Phone 7 и 8
• Windows 8

Особенности Amazon Fire OS

• Amazon Fire OS воспроизводит звуковой сигнал по умолчанию, заданный в настройках Настройки/Экран и звук.

Особенности Android

• Android воспроизводит стандартный звонок уведомления, заданный в настройках Настройки/Звуки и отображение.

Особенности Windows Phone 7 и 8

• Используется общий звуковой файл из распространения Cordova.

Особенности Tizen

• Tizen реализует звуковые сигналы путём воспроизведения аудиофайла через API мультимедиа.

• Файл звукового сигнала должен быть коротким, находиться в подкаталоге sounds корневого каталога приложения и именоваться beep.wav.