274 lines
8.7 KiB
Markdown
274 lines
8.7 KiB
Markdown
|
<!---
|
||
|
Licensed to the Apache Software Foundation (ASF) under one
|
||
|
or more contributor license agreements. See the NOTICE file
|
||
|
distributed with this work for additional information
|
||
|
regarding copyright ownership. The ASF licenses this file
|
||
|
to you under the Apache License, Version 2.0 (the
|
||
|
"License"); you may not use this file except in compliance
|
||
|
with the License. You may obtain a copy of the License at
|
||
|
|
||
|
http://www.apache.org/licenses/LICENSE-2.0
|
||
|
|
||
|
Unless required by applicable law or agreed to in writing,
|
||
|
software distributed under the License is distributed on an
|
||
|
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||
|
KIND, either express or implied. See the License for the
|
||
|
specific language governing permissions and limitations
|
||
|
under the License.
|
||
|
-->
|
||
|
|
||
|
# 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])
|
||
|
|
||
|
|
||
|
* **message**: 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`.
|