tree: 9905a61c3318151c3ee2a0bfd22d0c3930cf6b42 [path history] [tgz]
  1. index.md
  2. README.md
doc/pl/README.md

cordova-plugin-dialogs

Build Status

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ślnieAlert)

  • buttonName: Nazwa przycisku. (String) (Opcjonalna, domyślnieOK)

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ślnieConfirm)

  • 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.