cordova-plugin-dialogs
Ten plugin umożliwia dostęp do niektórych rodzimych okna dialogowego elementy interfejsu użytkownika za pośrednictwem obiektu globalnego navigator.notification
.
Mimo, że obiekt jest dołączony do globalnego zakresu navigator
, to nie dostępne dopiero po zdarzeniu deviceready
.
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
console.log(navigator.notification);
}
Instalacja
cordova plugin add cordova-plugin-dialogs
Metody
navigator.notification.alert
navigator.notification.confirm
navigator.notification.prompt
navigator.notification.beep
navigator.notification.alert
Pokazuje niestandardowe wpisu lub okno dialogowe. Większość implementacji Cordova używać rodzimych okno dialogowe dla tej funkcji, ale niektóre platformy używać przeglądarki alert
funkcji, która jest zazwyczaj mniej konfigurowalny.
navigator.notification.alert(message, alertCallback, [title], [buttonName])
-
wiadomość: komunikat okna dialogowego. (String)
-
alertCallback: wywołanie zwrotne do wywołania, gdy okno dialogowe alert jest oddalona. (Funkcja)
-
tytuł: okno tytuł. (String) (Opcjonalna, domyślnie
Alert
) -
buttonName: Nazwa przycisku. (String) (Opcjonalna, domyślnie
OK
)
Przykład
function alertDismissed() {
// do something
}
navigator.notification.alert(
'You are the winner!', // message
alertDismissed, // callback
'Game Over', // title
'Done' // buttonName
);
Obsługiwane platformy
- Amazon Fire OS
- Android
- BlackBerry 10
- Firefox OS
- iOS
- Tizen
- Windows Phone 7 i 8
- Windows 8
- Windows
Windows Phone 7 i 8 dziwactwa
-
Istnieje wpis nie wbudowana przeglądarka, ale można powiązać w następujący sposób na wywołanie
alert()
w globalnym zasięgu:window.alert = navigator.notification.alert;
-
Zarówno
alert
iconfirm
są bez blokowania połączeń, których wyniki są tylko dostępne asynchronicznie.
Firefox OS dziwactwa:
Dostępne są zarówno rodzimych blokuje window.alert()
i bez blokowania navigator.notification.alert()
.
Jeżyna 10 dziwactwa
parametr wywołania zwrotnego Navigator.Notification.alert ("tekst", wywołanie zwrotne, 'tytuł', 'tekst')
jest przekazywana numer 1.
navigator.notification.confirm
Wyświetla okno dialogowe potwierdzenia konfigurowalny.
navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])
-
wiadomość: komunikat okna dialogowego. (String)
-
confirmCallback: wywołanie zwrotne do wywołania z indeksu z przycisku (1, 2 lub 3), lub gdy okno jest zwolniony bez naciśnij przycisk (0). (Funkcja)
-
tytuł: okno tytuł. (String) (Opcjonalna, domyślnie
Confirm
) -
buttonLabels: tablica ciągów, określając etykiety przycisków. (Tablica) (Opcjonalna, domyślnie [
OK,Cancel
])
confirmCallback
confirmCallback
wykonuje, gdy użytkownik naciśnie klawisz jeden z przycisków w oknie dialogowym potwierdzenia.
Wywołanie zwrotne wymaga argumentu buttonIndex
(numer), który jest indeksem wciśnięty przycisk. Należy zauważyć, że indeks używa, na podstawie jednego indeksowania, więc wartością jest 1
, 2
, 3
itd.
Przykład
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
);
Obsługiwane platformy
- Amazon Fire OS
- Android
- BlackBerry 10
- Firefox OS
- iOS
- Tizen
- Windows Phone 7 i 8
- Windows 8
- Windows
Windows Phone 7 i 8 dziwactwa
-
Istnieje funkcja wbudowana przeglądarka nie
window.confirm
, ale można go powiązać przypisując:window.confirm = navigator.notification.confirm;
-
Wzywa do
alert
iconfirm
są bez blokowania, więc wynik jest tylko dostępnych asynchronicznie.
Windows dziwactwa
-
Na Windows8/8.1 to nie można dodać więcej niż trzy przyciski do instancji MessageDialog.
-
Na Windows Phone 8.1 nie jest możliwe wyświetlić okno dialogowe z więcej niż dwoma przyciskami.
Firefox OS dziwactwa:
Dostępne są zarówno rodzimych blokuje window.confirm()
i bez blokowania navigator.notification.confirm()
.
navigator.notification.prompt
Wyświetla okno dialogowe macierzystego, który bardziej niż przeglądarki prompt
funkcja.
navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])
-
wiadomość: komunikat okna dialogowego. (String)
-
promptCallback: wywołanie zwrotne do wywołania z indeksu z przycisku (1, 2 lub 3), lub gdy okno jest zwolniony bez naciśnij przycisk (0). (Funkcja)
-
title: okno tytuł (String) (opcjonalna, domyślnie
polecenia
) -
buttonLabels: tablica ciągów, określając przycisk etykiety (tablica) (opcjonalna, domyślnie
["OK", "Anuluj"]
) -
defaultText: domyślnie pole tekstowe wprowadzania wartości (
String
) (opcjonalna, domyślnie: pusty ciąg)
promptCallback
promptCallback
wykonuje, gdy użytkownik naciśnie klawisz jeden z przycisków w oknie dialogowym polecenia. Obiektu results
przekazane do wywołania zwrotnego zawiera następujące właściwości:
-
buttonIndex: indeks wciśnięty przycisk. (Liczba) Należy zauważyć, że indeks używa, na podstawie jednego indeksowania, więc wartością jest
1
,2
,3
itd. -
input1: Tekst wprowadzony w oknie polecenia. (String)
Przykład
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
);
Obsługiwane platformy
- Amazon Fire OS
- Android
- Firefox OS
- iOS
- Windows Phone 7 i 8
- Windows 8
- Windows
Dziwactwa Androida
-
Android obsługuje maksymalnie trzy przyciski i więcej niż to ignoruje.
-
Android 3.0 i nowszych przyciski są wyświetlane w kolejności odwrotnej do urządzenia, które używają tematu Holo.
Windows dziwactwa
- W systemie Windows wierzyciel okno jest oparte na języku html, ze względu na brak takich natywnego api.
Firefox OS dziwactwa:
Dostępne są zarówno rodzimych blokuje window.prompt()
i bez blokowania navigator.notification.prompt()
.
navigator.notification.beep
Urządzenie odtwarza sygnał ciągły dźwięk.
navigator.notification.beep(times);
- times: liczba powtórzeń po sygnale. (Liczba)
Przykład
// Beep twice!
navigator.notification.beep(2);
Obsługiwane platformy
- Amazon Fire OS
- Android
- BlackBerry 10
- iOS
- Tizen
- Windows Phone 7 i 8
- Windows 8
Amazon ogień OS dziwactwa
- Amazon ogień OS gra domyślny Dźwięk powiadomienia określone w panelu ekranu/ustawienia i dźwięk.
Dziwactwa Androida
- Android gra domyślnie dzwonek powiadomienia określone w panelu ustawień/dźwięk i wyświetlacz.
Windows Phone 7 i 8 dziwactwa
- Opiera się na pliku rodzajowego sygnał z rozkładu Cordova.
Dziwactwa Tizen
-
Tizen implementuje dźwięków przez odtwarzania pliku audio za pośrednictwem mediów API.
-
Plik dźwiękowy muszą być krótkie, musi znajdować się w podkatalogu
dźwięki
w katalogu głównym aplikacji i musi być o nazwiebeep.wav
.