cordova-plugin-dialogs

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

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

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

Установка

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
);

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

• Android
• Браузер
• iOS
• Windows

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
);

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

• Android
• Браузер
• iOS
• Windows

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

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

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

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

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

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
);

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

• Android
• Браузер
• iOS
• Windows

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

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

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

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

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

navigator.notification.beep

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

navigator.notification.beep(times);

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

Пример

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

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

• Android
• Браузер
• iOS
• Windows 8

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

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