sdgc-cordova-native-dialogs v1.0.0

cordova-plugin-dialogs

Fixed the issue in ios plugin where open dialogs got stuck. This is usefull as it now silently closes the open dialogs on app pause event.

Although the object is attached to the global scoped navigator, it is not available until after the deviceready event.

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

Installation

cordova plugin add sdgc-cordova-native-dialogs

Methods

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

navigator.notification.dismissAlertView

This function will close all/any opened alert/confirm/prompt box.

navigator.notification.dismissAlertView()

Example

navigator.notification.dismissAlertView();

Supported Platforms

• Android
• iOS

navigator.notification.alert

Shows a custom alert or dialog box. Most Cordova implementations use a native dialog box for this feature, but some platforms use the browser's alert function, which is typically less customizable.

Example

function alertDismissed() {
    // do something
}

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

Supported Platforms

• iOS
• Android

navigator.notification.confirm

Displays a customizable confirmation dialog box.

confirmCallback

The confirmCallback executes when the user presses one of the buttons in the confirmation dialog box.

The callback takes the argument buttonIndex (Number), which is the index of the pressed button. Note that the index uses one-based indexing, so the value is 1, 2, 3, etc.

Example

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

Supported Platforms

• iOS
• Android

navigator.notification.prompt

Displays a native dialog box that is more customizable than the browser's prompt function.

promptCallback

The promptCallback executes when the user presses one of the buttons in the prompt dialog box. The results object passed to the callback contains the following properties:

Example

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

Supported Platforms

• iOS
• Android

navigator.notification.beep

The device plays a beep sound.

navigator.notification.beep(times);

Example

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

Supported Platforms

• iOS
• Android