# cordova-plugin-dialogs [![Build Status](https://travis-ci.org/apache/cordova-plugin-dialogs.svg)](https://travis-ci.org/apache/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` i `confirm` 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` i `confirm` 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 nazwie `beep.wav`.