Installation
cordova plugin add cordova-plugin-dialogs
Methods
navigator.notification.alert
navigator.notification.confirm
navigator.notification.prompt
navigator.notification.beep
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.
navigator.notification.alert(message, alertCallback, [title], [buttonName])
Example
function alertDismissed() {
// do something
}
navigator.notification.alert(
'You are the winner!', // message
alertDismissed,
// callback
'Game Over',
// title
'Done'
// buttonName
);
Supported Platforms
Amazon Fire OS
Android
BlackBerry 10
Firefox OS
iOS
Tizen
Windows 8
Windows
There is no built-in browser alert, but you can bind one as follows to
call alert() in the global scope:
window.alert = navigator.notification.alert;
Both alert and confirm are non-blocking calls, results of which are only
available asynchronously.
Firefox OS Quirks:
Both native-blocking window.alert() and non-blocking navigator.notification.alert() are
available.
BlackBerry 10 Quirks
navigator.notification.alert('text', callback, 'title', 'text')
the number 1.
navigator.notification.confirm
Displays a customizable confirmation dialog box.
navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])
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
Amazon Fire OS
Android
BlackBerry 10
Firefox OS
iOS
Tizen
Windows 8
Windows
There is no built-in browser function for window.confirm, but you can bind it
by assigning:
window.confirm = navigator.notification.confirm;
Calls to alert and confirm are non-blocking, so the result is only available
asynchronously.
Windows Quirks
On Windows Phone 8.1 it's not possible to show dialog with more than two
buttons.
Firefox OS Quirks:
Both native-blocking window.confirm() and nonblocking navigator.notification.confirm() are available.
navigator.notification.prompt
Displays a native dialog box that is more customizable than the
browser's prompt function.
navigator.notification.prompt(message, promptCallback, [title], [buttonLabels],
[defaultText])
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:
buttonIndex: The index of the pressed button. (Number) Note that the index
uses one-based indexing, so the value is1, 2, 3, etc.
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
Amazon Fire OS
Android
Firefox OS
iOS
Windows 8
Windows
Android Quirks
Android supports a maximum of three buttons, and ignores any more than
that.
On Android 3.0 and later, buttons are displayed in reverse order for devices
that use the Holo theme.
Windows Quirks
Firefox OS Quirks:
Both native-blocking window.prompt() and nonblocking navigator.notification.prompt() are available.
navigator.notification.beep
The device plays a beep sound.
navigator.notification.beep(times);
Example
// Beep twice!
navigator.notification.beep(2);
Supported Platforms
Amazon Fire OS
Android
BlackBerry 10
iOS
Tizen
Windows 8
Android Quirks
Tizen Quirks
Tizen implements beeps by playing an audio file via the media API.
The beep file must be short, must be located in a sounds subdirectory of the
application's root directory, and must be named beep.wav.