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

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

• 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 воспроизводит стандартный звонок уведомлений, указанный в разделе Настройки/Звук и отображение.