README.md 9.0 KB

cordova-plugin-dialogs

Build Status

Este plugin permite acceder a algunos elementos de interfaz de usuario nativa diálogo vía global navigator.notification objeto.

Aunque el objeto está unido al ámbito global navigator , no estará disponible hasta después de la deviceready evento.

document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
    console.log(navigator.notification);
}

Instalación

cordova plugin add cordova-plugin-dialogs

Métodos

  • navigator.notification.alert
  • navigator.notification.confirm
  • navigator.notification.prompt
  • navigator.notification.beep

navigator.notification.alert

Muestra un cuadro de alerta o cuadro de diálogo personalizado. La mayoría de las implementaciones de Cordova utilizan un cuadro de diálogo nativa para esta característica, pero algunas plataformas utilizan el navegador alert la función, que es típicamente menos personalizable.

navigator.notification.alert(message, alertCallback, [title], [buttonName])
  • message: mensaje de diálogo. (String)

  • alertCallback: Callback para invocar al diálogo de alerta es desestimada. (Función)

  • title: título de diálogo. (String) (Opcional, el valor predeterminado de Alert)

  • buttonName: nombre del botón. (String) (Opcional, por defecto Aceptar)

Ejemplo

function alertDismissed() {
    // do something
}

navigator.notification.alert(
    'You are the winner!',  // message
    alertDismissed,         // callback
    'Game Over',            // title
    'Done'                  // buttonName
);

Plataformas soportadas

  • Amazon fire OS
  • Android
  • BlackBerry 10
  • Firefox OS
  • iOS
  • Tizen
  • Windows Phone 7 y 8
  • Windows 8
  • Windows

Windows Phone 7 y 8 rarezas

  • No hay ninguna alerta del navegador integrado, pero puede enlazar uno proceda a llamar alert() en el ámbito global:

    window.alert = navigator.notification.alert;
    
  • alert y confirm son non-blocking llamadas, cuyos resultados sólo están disponibles de forma asincrónica.

Firefox OS rarezas:

Dos nativos de bloqueo window.alert() y no-bloqueo navigator.notification.alert() están disponibles.

BlackBerry 10 rarezas

navigator.notification.alert('text', callback, 'title', 'text')parámetro de devolución de llamada se pasa el número 1.

navigator.notification.confirm

Muestra un cuadro de diálogo de confirmación personalizables.

navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])
  • message: mensaje de diálogo. (String)

  • confirmCallback: Callback para invocar con índice de botón pulsado (1, 2 o 3) o cuando el diálogo es despedido sin la presión del botón (0). (Función)

  • title: título de diálogo. (String) (Opcional, por defecto a confirmar)

  • buttonLabels: matriz de cadenas especificando las etiquetas de botón. (Matriz) (Opcional, por defecto [OK, cancelar])

confirmCallback

El confirmCallback se ejecuta cuando el usuario presiona uno de los botones en el cuadro de diálogo de confirmación.

La devolución de llamada toma el argumento buttonIndex (número), que es el índice del botón presionado. Observe que el índice utiliza indexación basada en uno, entonces el valor es 1 , 2 , 3 , etc..

Ejemplo

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
);

Plataformas soportadas

  • Amazon fire OS
  • Android
  • BlackBerry 10
  • Firefox OS
  • iOS
  • Tizen
  • Windows Phone 7 y 8
  • Windows 8
  • Windows

Windows Phone 7 y 8 rarezas

  • No hay ninguna función de navegador incorporado para window.confirm, pero lo puede enlazar mediante la asignación:

    window.confirm = navigator.notification.confirm;
    
  • Llamadas de alert y confirm son non-blocking, así que el resultado sólo está disponible de forma asincrónica.

Windows rarezas

  • Sobre Windows8/8.1 no es posible agregar más de tres botones a instancia de MessageDialog.

  • En Windows Phone 8.1 no es posible Mostrar cuadro de diálogo con más de dos botones.

Firefox OS rarezas:

Dos nativos de bloqueo window.confirm() y no-bloqueo navigator.notification.confirm() están disponibles.

navigator.notification.prompt

Muestra un cuadro de diálogo nativa que es más personalizable que del navegador prompt función.

navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])
  • message: mensaje de diálogo. (String)

  • promptCallback: Callback para invocar con índice del botón pulsado (1, 2 ó 3) o cuando el cuadro de diálogo es despedido sin la presión del botón (0). (Función)

  • título: título (String) (opcional, por defecto de diálogoPrompt)

  • buttonLabels: matriz de cadenas especificando botón etiquetas (Array) (opcional, por defecto["OK","Cancel"])

  • defaultText: valor de la entrada predeterminada textbox ( String ) (opcional, por defecto: cadena vacía)

promptCallback

El promptCallback se ejecuta cuando el usuario presiona uno de los botones del cuadro de diálogo pronto. El results objeto que se pasa a la devolución de llamada contiene las siguientes propiedades:

  • buttonIndex: el índice del botón presionado. (Número) Observe que el índice utiliza indexación basada en uno, entonces el valor es 1 , 2 , 3 , etc..

  • INPUT1: el texto introducido en el cuadro de diálogo pronto. (String)

Ejemplo

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
);

Plataformas soportadas

  • Amazon fire OS
  • Android
  • Firefox OS
  • iOS
  • Windows Phone 7 y 8
  • Windows 8
  • Windows

Rarezas Android

  • Android soporta un máximo de tres botones e ignora nada más.

  • En Android 3.0 y posteriores, los botones aparecen en orden inverso para dispositivos que utilizan el tema Holo.

Windows rarezas

  • En Windows pronto diálogo está basado en html debido a falta de tal api nativa.

Firefox OS rarezas:

Dos nativos de bloqueo window.prompt() y no-bloqueo navigator.notification.prompt() están disponibles.

navigator.notification.beep

El aparato reproduce un sonido sonido.

navigator.notification.beep(times);
  • tiempos: el número de veces a repetir la señal. (Número)

Ejemplo

// Beep twice!
navigator.notification.beep(2);

Plataformas soportadas

  • Amazon fire OS
  • Android
  • BlackBerry 10
  • iOS
  • Tizen
  • Windows Phone 7 y 8
  • Windows 8

Amazon fuego OS rarezas

  • Amazon fuego OS reproduce el Sonido de notificación especificados en el panel de configuración/pantalla y sonido por defecto.

Rarezas Android

  • Androide reproduce el tono de notificación especificados en el panel ajustes de sonido y visualización por defecto.

Windows Phone 7 y 8 rarezas

  • Se basa en un archivo de sonido genérico de la distribución de Córdoba.

Rarezas Tizen

  • Tizen implementa pitidos por reproducir un archivo de audio a través de los medios de comunicación API.

  • El archivo de sonido debe ser corto, debe estar ubicado en un sounds subdirectorio del directorio raíz de la aplicación y deben ser nombradosbeep.wav.