michael@0: <!---
michael@0:     Licensed to the Apache Software Foundation (ASF) under one
michael@0:     or more contributor license agreements.  See the NOTICE file
michael@0:     distributed with this work for additional information
michael@0:     regarding copyright ownership.  The ASF licenses this file
michael@0:     to you under the Apache License, Version 2.0 (the
michael@0:     "License"); you may not use this file except in compliance
michael@0:     with the License.  You may obtain a copy of the License at
michael@0: 
michael@0:       http://www.apache.org/licenses/LICENSE-2.0
michael@0: 
michael@0:     Unless required by applicable law or agreed to in writing,
michael@0:     software distributed under the License is distributed on an
michael@0:     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
michael@0:     KIND, either express or implied.  See the License for the
michael@0:     specific language governing permissions and limitations
michael@0:     under the License.
michael@0: -->
michael@0: 
michael@0: # org.apache.cordova.dialogs
michael@0: 
michael@0: Ten plugin umożliwia dostęp do niektórych rodzimych okna dialogowego elementy interfejsu użytkownika.
michael@0: 
michael@0: ## Instalacja
michael@0: 
michael@0:     cordova plugin add org.apache.cordova.dialogs
michael@0:     
michael@0: 
michael@0: ## Metody
michael@0: 
michael@0: *   `navigator.notification.alert`
michael@0: *   `navigator.notification.confirm`
michael@0: *   `navigator.notification.prompt`
michael@0: *   `navigator.notification.beep`
michael@0: 
michael@0: ## navigator.notification.alert
michael@0: 
michael@0: 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` funkcja, który jest zazwyczaj mniej konfigurowalny.
michael@0: 
michael@0:     navigator.notification.alert(message, alertCallback, [title], [buttonName])
michael@0:     
michael@0: 
michael@0: *   **wiadomość**: komunikat okna dialogowego. *(String)*
michael@0: 
michael@0: *   **alertCallback**: wywołanie zwrotne do wywołania, gdy okno dialogowe alert jest oddalona. *(Funkcja)*
michael@0: 
michael@0: *   **tytuł**: okno tytuł. *(String)* (Opcjonalna, domyślnie`Alert`)
michael@0: 
michael@0: *   **buttonName**: Nazwa przycisku. *(String)* (Opcjonalna, domyślnie`OK`)
michael@0: 
michael@0: ### Przykład
michael@0: 
michael@0:     function alertDismissed() {
michael@0:         // do something
michael@0:     }
michael@0:     
michael@0:     navigator.notification.alert(
michael@0:         'You are the winner!',  // message
michael@0:         alertDismissed,         // callback
michael@0:         'Game Over',            // title
michael@0:         'Done'                  // buttonName
michael@0:     );
michael@0:     
michael@0: 
michael@0: ### Obsługiwane platformy
michael@0: 
michael@0: *   Amazon Fire OS
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 i 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Windows Phone 7 i 8 dziwactwa
michael@0: 
michael@0: *   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:
michael@0:     
michael@0:         window.alert = navigator.notification.alert;
michael@0:         
michael@0: 
michael@0: *   Zarówno `alert` i `confirm` są bez blokowania połączeń, których wyniki są tylko dostępne asynchronicznie.
michael@0: 
michael@0: ### Firefox OS dziwactwa:
michael@0: 
michael@0: Blokuje zarówno rodzimych `window.alert()` i bez blokowania `navigator.notification.alert()` są dostępne.
michael@0: 
michael@0: ## navigator.notification.confirm
michael@0: 
michael@0: Wyświetla okno dialogowe potwierdzenia konfigurowalny.
michael@0: 
michael@0:     navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])
michael@0:     
michael@0: 
michael@0: *   **wiadomość**: komunikat okna dialogowego. *(String)*
michael@0: 
michael@0: *   **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)*
michael@0: 
michael@0: *   **tytuł**: okno tytuł. *(String)* (Opcjonalna, domyślnie`Confirm`)
michael@0: 
michael@0: *   **buttonLabels**: tablica ciągów, określając etykiety przycisków. *(Tablica)* (Opcjonalna, domyślnie [ `OK,Cancel` ])
michael@0: 
michael@0: ### confirmCallback
michael@0: 
michael@0: `confirmCallback`Wykonuje, gdy użytkownik naciśnie klawisz jeden z przycisków w oknie dialogowym potwierdzenia.
michael@0: 
michael@0: Wywołania zwrotnego przyjmuje argument `buttonIndex` *(numer)*, który jest indeksem wciśnięty przycisk. Uwaga, że indeks używa, na podstawie jednego indeksowania, więc wartość jest `1` , `2` , `3` , itp.
michael@0: 
michael@0: ### Przykład
michael@0: 
michael@0:     function onConfirm(buttonIndex) {
michael@0:         alert('You selected button ' + buttonIndex);
michael@0:     }
michael@0:     
michael@0:     navigator.notification.confirm(
michael@0:         'You are the winner!', // message
michael@0:          onConfirm,            // callback to invoke with index of button pressed
michael@0:         'Game Over',           // title
michael@0:         ['Restart','Exit']     // buttonLabels
michael@0:     );
michael@0:     
michael@0: 
michael@0: ### Obsługiwane platformy
michael@0: 
michael@0: *   Amazon Fire OS
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 i 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Windows Phone 7 i 8 dziwactwa
michael@0: 
michael@0: *   Istnieje funkcja wbudowana przeglądarka nie `window.confirm` , ale można go powiązać przypisując:
michael@0:     
michael@0:         window.confirm = navigator.notification.confirm;
michael@0:         
michael@0: 
michael@0: *   Wzywa do `alert` i `confirm` są bez blokowania, więc wynik jest tylko dostępnych asynchronicznie.
michael@0: 
michael@0: ### Firefox OS dziwactwa:
michael@0: 
michael@0: Blokuje zarówno rodzimych `window.confirm()` i bez blokowania `navigator.notification.confirm()` są dostępne.
michael@0: 
michael@0: ## navigator.notification.prompt
michael@0: 
michael@0: Wyświetla okno dialogowe macierzystego, który bardziej niż przeglądarki `prompt` funkcja.
michael@0: 
michael@0:     navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])
michael@0:     
michael@0: 
michael@0: *   **wiadomość**: komunikat okna dialogowego. *(String)*
michael@0: 
michael@0: *   **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)*
michael@0: 
michael@0: *   **tytuł**: okno tytuł *(String)* (opcjonalna, domyślnie`Prompt`)
michael@0: 
michael@0: *   **buttonLabels**: tablica ciągów, określając przycisk etykiety *(tablica)* (opcjonalna, domyślnie`["OK","Cancel"]`)
michael@0: 
michael@0: *   **defaultText**: wartość wejściowa tekstowym domyślnego ( `String` ) (opcjonalna, domyślnie: pusty ciąg)
michael@0: 
michael@0: ### promptCallback
michael@0: 
michael@0: `promptCallback`Wykonuje, gdy użytkownik naciśnie klawisz jeden z przycisków w oknie dialogowym polecenia. `results`Obiekt przekazywany do wywołania zwrotnego zawiera następujące właściwości:
michael@0: 
michael@0: *   **buttonIndex**: indeks wciśnięty przycisk. *(Liczba)* Uwaga, że indeks używa, na podstawie jednego indeksowania, więc wartość jest `1` , `2` , `3` , itp.
michael@0: 
michael@0: *   **input1**: Tekst wprowadzony w oknie polecenia. *(String)*
michael@0: 
michael@0: ### Przykład
michael@0: 
michael@0:     function onPrompt(results) {
michael@0:         alert("You selected button number " + results.buttonIndex + " and entered " + results.input1);
michael@0:     }
michael@0:     
michael@0:     navigator.notification.prompt(
michael@0:         'Please enter your name',  // message
michael@0:         onPrompt,                  // callback to invoke
michael@0:         'Registration',            // title
michael@0:         ['Ok','Exit'],             // buttonLabels
michael@0:         'Jane Doe'                 // defaultText
michael@0:     );
michael@0:     
michael@0: 
michael@0: ### Obsługiwane platformy
michael@0: 
michael@0: *   Amazon Fire OS
michael@0: *   Android
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Windows Phone 7 i 8
michael@0: 
michael@0: ### Dziwactwa Androida
michael@0: 
michael@0: *   Android obsługuje maksymalnie trzy przyciski i więcej niż to ignoruje.
michael@0: 
michael@0: *   Android 3.0 i nowszych przyciski są wyświetlane w kolejności odwrotnej do urządzenia, które używają tematu Holo.
michael@0: 
michael@0: ### Firefox OS dziwactwa:
michael@0: 
michael@0: Blokuje zarówno rodzimych `window.prompt()` i bez blokowania `navigator.notification.prompt()` są dostępne.
michael@0: 
michael@0: ## navigator.notification.beep
michael@0: 
michael@0: Urządzenie odtwarza sygnał ciągły dźwięk.
michael@0: 
michael@0:     navigator.notification.beep(times);
michael@0:     
michael@0: 
michael@0: *   **razy**: liczba powtórzeń po sygnale. *(Liczba)*
michael@0: 
michael@0: ### Przykład
michael@0: 
michael@0:     // Beep twice!
michael@0:     navigator.notification.beep(2);
michael@0:     
michael@0: 
michael@0: ### Obsługiwane platformy
michael@0: 
michael@0: *   Amazon Fire OS
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 i 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Amazon ogień OS dziwactwa
michael@0: 
michael@0: *   Amazon ogień OS gra domyślny **Dźwięk powiadomienia** określone w panelu **ekranu/ustawienia i dźwięk** .
michael@0: 
michael@0: ### Dziwactwa Androida
michael@0: 
michael@0: *   Android gra domyślnie **dzwonek powiadomienia** określone w panelu **ustawień/dźwięk i wyświetlacz** .
michael@0: 
michael@0: ### Windows Phone 7 i 8 dziwactwa
michael@0: 
michael@0: *   Opiera się na pliku rodzajowego sygnał z rozkładu Cordova.
michael@0: 
michael@0: ### Dziwactwa Tizen
michael@0: 
michael@0: *   Tizen implementuje dźwięków przez odtwarzania pliku audio za pośrednictwem mediów API.
michael@0: 
michael@0: *   Plik dźwiękowy muszą być krótkie, musi znajdować się w `sounds` podkatalogu katalogu głównego aplikacji i musi być nazwany`beep.wav`.